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INTRODUCTION 

1. NEWSCOOP FOR EDITORS AND JOURNALISTS 

2. FEATURE LIST 



NEWSCOOP FOR EDITORS AND JOURNALISTS 



Newscoop is a multi-lingual enterprise o 
scheduled publishing of multimedia. Built-ir 



it management system for on-line newspapers and magazines, enabling 
avenue generation features include support for both trial and paid reader 



subscriptions. The interface is built with the journalist, editor and publisher in mind, based on feedback from the n 
organizations around the world that have deployed Sourcefabric's newsroom software since the launch of the first version 
of Campsite in 1999. Newscoop follows a print publishing model, so it structures websites as Publications, Issues, Sections 
and Articles by default. Newscoop was designed for medium-to-large on-line publications, but it is capable of handling 
nimbler sites too. 
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With Newscoop, you can edit articles using an advanced WYSIWYG interface, and manage articles translated into different 
languages. A traditional editorial process ensures quality of content: the journalist writes the article, the editor reviews 
the content, and then the article can be published. The Newscoop editorial interface works in most modern web 
browsers, including Mozilla Firefox and Microsoft Internet Explorer. No browser plug-ins 




You can also create your own definition of what a particular type of article should include. For example, one article type 
might consist of "Intro", "Body", and "References", while another type might include only "Body" and "Author Bio". You can 
incorporate images, audio and video into your articles, for delivery directly in the browser window or as attachments for 
download. Articles can be categorized with topics, and scheduled for release at a future date, or published immediately. 

Newscoop offers full control over the look and feel of your web site via a flexible HTML5 and CSS3 ready templating 
engine. The PHP object-oriented API enables your website developers to build third-party plug-ins too. Built-in support for 
translation allows the user interface to be adapted to support new languages quickly and easily. 



;, including journalists, editc 
:ss control for paid group 



Managers will appreciate the fine-grained access control for different types of staff us 
and subscription managers. Integrated revenue-generating features include IP-based a 
subscriptions. 

Newscoop is Open Source software released by Sourcefabric under the GNU General Public License. It incorporates 
TinyMCE from Moxiecode Systems AB as its WYSIWYG text editor, Christophe Dolivet's EditArea as a template editc 
PhotoViewer by Joseph Nicora for thumbnail zooming. 



FEATURE LIST 



This list of features is provided as a guide to help you decide if Newscoop is the right content management system for 
your publication. 

MULTI-LINGUAL CONTENT 

All of the content that you create in Newscoop can be translated: 



ranslated into the following languages (in alphabetical order): 



• 


Articles 


• Sections 


• Publications 


• Topics (content categorization) 


• File attachment descriptions 


The Newscoop administration interface has been 


1. Arabic 


2 


Belarusian 


3 


Chinese (Simplified) 


4 


Chinese (Traditional) 


5 


Croatian 


6 


Czech 


7 


Dutch 


8 


English 


9 


French 


10 


Georgian 


11 


German 


12 


Korean 


13 


Polish 


14 


Portuguese 


15 


Romanian 


16 


Russian 


17 


Serbian (Cyrillic) 


18 


Serbo-Croatian (Latin) 


19 


Spanish 


20 


Swedish 



Further translations can be added using a tool built into Newscoop called the "Localizer". 

REVENUE GENERATION 

1. Control access to your content via: 

• User's IP Address (for corporate accounts) 

• Login/password (for individual users) 

• Control the content your subscribers have access to: 



• Specific sections in each issue 

• Specific sections in a particular language 

' Support for a trial subscription period, for instant access while payment is made 

> Set your own pay periods (the time between each payment made by a subscriber) 

> Geolocation and mapping features, enabling location-based s 



EDITORIAL FEATURES 

1. Online WYSIWYG editor for article editing: 



• Typical style formatting: bold, italic, etc. 

• Special support for linking to existing (internal) articles 

• Ability to split articles into multiple pages 

• Insert images into your articles 

• Copy & Paste clean text from Microsoft Word or OpenOffice.org (while preserving bold and italics) 

• Insert subtitles, which can be used for breaking up the article (pagination) 

• Built with multiple simultaneous users in mind 

• While a journalist is editing an article, it is "locked". A warning will be displayed if anyone else tries to edit the article 
at the same time. This prevents one journalist from deleting the work of another 

• Group articles into sections 

• Group sections into an issue 

• Release an issue all at once 

• Allow subscribers to access only certain issues 

• Scheduled Publishing: automatically publish articles or issues at some time in the future. For articles, you can 
schedule the following actions: 

• publish 

• unpublish 

• show the article on the front page 
e the article from front page 

tide on the section page 

e the article from the section page 

• Topics: Categorize your content 

• Define however many topics you like 

• Associate any number of topics to an article 

• Topic can have subtopics, subtopics can have sub-subtopics, etc. 

• Topics can be translated 

• Dynamic, Flexible Article Types 

• "Article Types" allow you to define your own article format - you aren't limited to just "Introduction" and "Body" 
fields, for instance. An Article Type consists of a series of data fields 

• You can define any number and combination of the following field types: 

o date field 

o single-line text field 

o multiple-line text field with WYSIWYG editor 

o drop-down selection containing a list of topics 

• Reorder how the fields are displayed in the admin interface 

• Hide fields that are no longer in use 

• Translate the field names 

• Change the data type for a field 

• Image Manager 

• View/search all of the images in the system 

• Edit image metadata 

• Scale images any way you want on the fly. Scaled versions are cached 

» File Attachments 

• Attach files to articles 

• Files can have descriptions 

• You can specify whether the file should be displayed in the browser or popup a download window 

• Comments 

• Readers can make comments to articles 

• Comments can be linked to a forum 

• Flexible implementation: allow anyone to comment, just subscribers, logged in 

• Comments can be moderated 

• Built-in CAPTCHA for spam prevention 

• Works with SSL on both the front-end and back-end 



SITE DESIGN 

Newscoop has its own template language specifically made for online newspapers and magazines. It allows you tc 
customize your site however you want. 

• You have access to the following data objects: 

o issues 

o sections 

o articles 

o topics 

o current user 

o current language (e.g. automatically show the user an article in their language) 

• Control statements such as IF and LIST 

• Include other templates 

• Built on the SMARTY templating engine which allows easy customization and inclusion of third party modules 

ADMINISTRATION 

1. Fine-grained access control, you can create different user types such as: 

• journalists 

• editors 

• photographers 

• photo editors 

• subscriber managers 

• site administrators 

• Multiple author support with contact information, biographies and article tracking 

• All administration actions are logged 

• Security 

• Login page secured against automated scripting attacks with a CAPTCHA 

• Login password is encrypted when sent to the server 



• Command-line "backup" and "restore" scripts make it easy to backup your entire site and restore it with one 
command 

• You can also easily transfer your site from one server to another using these scripts 

• Automated Feedback and Bug Reporting 

• If something goes wrong in the administration interface, a special screen will appear which allows you to submit the 
problem back to the Newscoop team 

• You can also submit feedback directly in the administration interface, such as suggestions or feature requests 

DEVELOPERS 

• Completely open-source LAMP development stack (Linux, Apache, MySQL, and PHP) 

• Easy to use object-oriented API to develop plugins or alternative interfaces 

• Easy-to-read code 

• Open development process - all planning, specs, and reviews are done in the open. Developing Newscoop is a 
community process 

FULL COMMERCIAL SUPPORT 

• Paid per-incident support is available from Sourcefabric (http://www.sourcefabric.org) . Guaranteed support contracts 
ensure a 24-hour response time 

• If you need additional features in Newscoop, they can be ordered from Sourcefabric at a very reasonable cost and 
delivered in a timely manner 

• Sourcefabric has a team of full-time developers working to make Newscoop easier to use, with the features you 
want 

• Community support is available via mailing lists and forums (http://forum.sourcefabric.org) 



INSTALLATION 

3. AUTOMATED INSTALLATION 

4. MANUAL INSTALLATION 

5. INSTALLATION STEPS 

6. BACKUP AND UPGRADE 



AUTOMATED INSTALLATION 



Ready made packages of Newscoop are available for Debian and Ubuntu GNU/Linux via secure apt . This is the 
recommended installation method for Newscoop, because it offers automatic updates and resolution of package 
dependencies. This guide assumes that you have sudo or root powers on the target server - if not, you need to ask your 
system administrator to install Newscoop for you. 

INSTALLING MYSQL 

Two components of MySQL are needed for Newscoop: 

• the server 

• the client programs 

Depending on your requirements, you may prefer to run the MySQL database server on a separate machine from the 
MySQL client. The client must be installed on the same machine as Newscoop. On Debian/Ubuntu, installing the mysql- 
server metapackage will install the latest versions of both the server and client packages. 

$ sudo apt-get install mysql-server 

During the installation of MySQL, you should be prompted to set a root password for the MySQL server, which is an 
important security feature. Make a note of this password and keep it in a secure place, as you will need it shortly. 

□ 

Note that the MySQL root user is different from the system root user, and should have a different password. 

SETTING UP THE DATABASE USER AND PASSWORD 

An existing Newscoop installation should have a named database already set up on a MySQL server, with access 
protected by a username and password. For a new installation of Newscoop, you will need to tell the installer to create a 
database to store your content in. This means you will need a MySQL user account with database creation privileges set 
up in advance. If you don't already have an account, you can set up a database username and password for the 
Newscoop installer to use with the following steps. 

1. Connect to the database management system using the root account and the password that you set during the MySQL 
installation. 

Enter password: 

Welcome to the MySQL monitor. Commands end with ; or \g. 

Your MySQL connection id is 34 



2. The shell prompt will change to a mysql> prompt, which requires a semicolon at the end of each command. Create a 
user account for Newscoop to connect to the database, limiting it to connecting from the localhost if Newscoop and 
MySQL are to be installed on the same server. Otherwise, specify the server that Newscoop will be connecting to MySQL 
from. Make a note of the username (newscoop_user in the example below) and password (hewscoop_user_password 
in the example) that you set, in a secure place. You will need these details during the Newscoop installation. 

mysql> CREATE USER ' newscoop„user ' @ ' localhost ' 
-> IDENTIFIED BY ' newscoop_user_password ' ; 
Query OK, rows affected (0.04 sec) 

4. Grant access privileges to the user you just created. In this example, newscoop.* means all tables of a database 
called newscoop, which has not yet been created. You will need to provide this database name to the Newscoop 
installer, so that it can create the database later. 

mysql> GRANT ALL ON newscoop.* 

-> TO 'newscoop_user '@'localhost ' ; 
Query OK, rows affected (0.00 sec) 



5. Exit from the database management system and return to the shell prompt. 



INSTALLING DEPENDENCIES 

The apache2 metapackage will install all of the web server packages you need. 
The php5-cli, php5-mysql and php5-gd modules must be installed. 

$ sudo apt-get install php5-cli php5-mysql php5-gd 

The imagemagick package is needed for creating thumbnails. 

The wwwconfig-common package helps set up the web server for you. 



PHP CONFIGURATION 

The php.ini file contains some default settings which should be checked or adjusted to enable optimum Newscoop 
performance and security. You can do this by opening the file in your text editor: 

$ sudo nano /etc/php5/apache2/php. ini 

You may wish to adjust the following two settings, which affect the maximum size of media that Newscoop users can 
upload. 

1. The maximum size of POST data that PHP will accept defaults to 8MB on Debian/Ubuntu. You may find that you need 
to set this higher, for example: 



2. The maximum allowed size for uploaded files defaults to 2MB on Debian/Ubuntu. This is likely to be insufficient for large 
multimedia attachments, so you may wish to set this value higher. However, it must not be higher than the maximum 
POST size set above, otherwise large uploads may fail. 

upload_max_filesize = 100M 

3. You may also wish to disable automatic session garbage collection, which can cause permissions errors to be shown in 
the browser. Debian and Ubuntu use a cron job /etc/cron.d/php5 to perform garbage collection instead. 



Press Ctrl+O to write out the php.ini file, and Ctrl-X to quit the nano editor. 

INSTALLING THE ALTERNATIVE PHP CACHE 

This step is optional, but highly recommended for optimum Newscoop performance. On Debian or Ubuntu, you can ir 
APC with the following steps: 

$ sudo apt-get install php-apc 

Then restart Apache to enable the APC module. 



APACHE CONFIGURATION 

The Apache web server's configuration will need to be adjusted to set the path to the Newscoop files and templates. On 
Debian or Ubuntu, Apache configuration files are usually found in the /etc/apache2/sites-available/ directory. 

1. Create a file such as newscoop containing a virtual host definition. 



For a publication with the domain name www.example.com, you could use a virtual host definition like the following: 



ServerAlia 
10 



If the ServerName or ServerAlias that you are using is not yet set up in DNS for this particular machine's IP address, yot 
can create a temporary hostname in your /etc/hosts/ file which will enable you to test the installation locally. 

2. Disable the default Apache configuration, if you aren't using it. 



3. Enable the Newscoop configuration that you just created. 

$ sudo a2ensite newscoop 
Enabling s 



4. You may also need to enable Apache's 
command: 



e module. On Debian/Ubur 



n do this with the a2enmod 



The server should respond: 

Enabling module rewrite. 

Run '/etc/init .d/apache2 restart' to activate new configuration! 

5. Restart Apache as suggested by the output of the command above, so that the Newscoop configuration and the n 
modules can be loaded: 

$ sudo /etc/init .d/apache2 restart 

The server should respond: 



SETTING UP THE SECURE APT REPOSITORY 



To add the repository that contains the Newscoop software, open the 

$ sudo nano /etc/apt/sources. list 



.list file in the nano editor with: 



Type your password, and the 
the following line: 



t file will open. For Ubuntu Lucid LTS, scroll to the end of this document and add 



For Ubuntu Maverick, substitute maverick-backports in place of lucid-backports. For Debian Squeeze, substitute squeeze- 
backports in place of lucid-backports. 




Press Ctrl+O to write out the sources. list file, and Ctrl-X to quit the nano editc 
You now need to update your sources. Type: 

You will probably see an error message about a missing public key. 




using a trusted software repository: 



Update your sources again, to confirm that you 

You should no longer see the error message about the public key. 

INSTALLING THE NEWSCOOP PACKAGE 

After confirming that the secure apt repository is set up, you can install the Newscoop package: 

This command will install all of the Newscoop components, plus any other packages that Newscoop requires in order t 




Finally, check that Newscoop is running. Open a web browser with the URL of the Apache ServerName or ServerAlias 
that you have set up earlier. If you see the Newscoop installer page, you can now skip the chapter Manual Installation and 
proceed to the chapter Installation Steps. 



MANUAL INSTALLATION 



The following manual installation method is intended for more experienced system administrators, and assumes that you 
have sudo or root powers on the target server. If ready-made packages of Newscoop are not available for your 
GNU/Linux distribution of choice, you can install the software manually using the tarball available for download from 
Sourcefabric: 

http://newscoop.sourcefabric.org/ 

DEPENDENCIES 

Before performing a manual installation, you will have to verify that all of the dependency packages that Newscoop 
requires are already installed and working. These dependencies are: 

1. Apache web server (http://www.apache.org) version 2.0.x or newer. 

On Debian or Ubuntu GNU/Linux, you can install the apache2 metapackage, which will install all of the web server 
packages you need. 



2. MySQL database management system (http://w 



Two components of MySQL are needed for Newscoop: 



• the client program 



These components are usually packaged separately, because you may prefer to run the MySQL server on another 
machine from the MySQL client, which must be installed on the same machine as Newscoop. On Debian/Ubuntu, installing 
the mysql-server metapackage will install the latest versions of both the server and client packages. 



During the installation of MySQL, you should be prompted to set a root password for the MySQL server, which is ar 
important security feature. Make a note of this password and keep it in a secure place, as you will need it shortly. 



— | Configuring mysql-; 



While not mandatory, it is highly recommended that you set a password 
for the MySQL administrative "root" user. 

If this field is left blank, the password will not be changed. 

New password for the MySQL "root" user: 



Note that the MySQL root user is different from the system root user, and should have a different password. 
3. PHP scripting language (http://www.php.net) version 5.0 or newer. 
The following PHP modules must be installed: 

• php5-cli - Command Line Interface module 

• php5-mysql - functions for accessing the MySQL database server 

• php5-gd - provides a module for handling graphics from PHP scripts 

$ sudo apt-get install php5-cli php5-mysql php5-gd 

These modules have the same names in the equivalent Debian/Ubuntu packages. You will also need the PHP module for 
the Apache web server, which has the package name Nbapache2-mod-php5 in Debian/Ubuntu. This package should be 
installed automatically as a dependency when installing the PHP packages mentioned above. 



4. ImageMagick (http://www.imagemagick.org) . 

Needed for creating thumbnails of images. Available in Debian/Ubuntu's imagemagick package. 



All of these Newscoop dependencies are available as standard packages in most GNU/Linux distributions. You should be 
able to find them using your distribution's software package manager, although the exact package names can vary from 
the examples given above for Debian/Ubuntu. 

SETTING UP THE DATABASE USER AND PASSWORD 

An existing Newscoop installation should have a named database already set up on a MySQL server, with access 
protected by a username and password. For a new installation of Newscoop, you will need to tell the installer to create a 
database to store your content in. This means you will need a MySQL user account with database creation privileges set 
up in advance. If you don't already have an account, you can set up a database username and password for the 
Newscoop installer to use with the following steps. 

and the password that you set during the MySQL 



1. Connect to 
installation. 


the database rr 


lanagement syster 


n using the root 


Enter passwon 
Welcome to th> 
Your MySQL coi 
Server versioi 


e MySQL monitor 
n; 5.1.41-3ubun 


34 

tul2.8 (Ubuntu) 


Lth ; or \g. 


Type 'help;' . 


or '\h' for hel 


p. Type '\c' to c 


Lear the current 



2. The shell prompt will change to a mysql> prompt, which requires a semicolon at the end of each command. Create a 
user account for Newscoop to connect to the database, limiting it to connecting from the localhost if Newscoop and 
MySQL are to be installed on the same server. Otherwise, specify the server that Newscoop will be connecting to MySQL 
from. Make a note of the username (newscoop_user in the example below) and password (hewscoop_user_password 
in the example) that you set, in a secure place. You will need these details during the Newscoop installation. 

mysql> CREATE USER ' newscoop„user ' @ ' localhost ' 
-> IDENTIFIED BY ' newscoop_user_password ' ; 
Query OK, rows affected (0.04 sec) 

4. Grant access privileges to the user you just created. In this example, newscoop.* means all tables of a database 
called newscoop, which has not yet been created. You will need to provide this database name to the Newscoop 
installer, so that it can create the database later. 

mysql> GRANT ALL ON newscoop.* 

-> TO 'newscoop_user '@' localhost ' ; 
Query OK, rows affected (0.00 sec) 

5. Exit from the database management system and return to the shell prompt. 

mysql> quit; 



PHP MODULES 

On Debian or Ubuntu, the PHP modules that you have installed should be configured automatically, with an entry for each 
module added to the /etc/php5/apache2/conf.d/ directory. You can also create your own PHP customization options using 
files in that directory, which should not be overwritten when the main php.ini file is upgraded. 

On other distributions of GNU/Linux, you may need to add a line for each module to the php.ini file, such as 
/etc/php5/apache2/php.ini or similar. The following extensions should be enabled. If the line is already present but 
starts with the semi-colon comment ';' you will need to remove this character for the corresponding extension to work. 



PHP CONFIGURATION 

On any GNU/Linux distribution, the php.ini file contains some default settings which should be checked or adjusted t' 
enable optimum Newscoop performance and security. You can do this by opening the file in your text editor: 



$ sudo nano /etc/php5/apache2/php. ini 

The recommend settings are that you should: 

1. Turn off register_globals because it's a potential security hole: 

2. Set the amount of memory available to at least 128MB: 



3. Turn off magic quotes: 

magic_quotes_gpc = Off 

4. Allow HTTP file uploads: 

file_uploads = On 

The values above are the default settings on Debian or Ubuntu. You may wish to adjust the following two settings, which 
affect the maximum size of media that Newscoop users can upload. 

5. The maximum size of POST data that PHP will accept defaults to 8MB on Debian/Ubuntu. You may find that you need 
to set this higher, for example: 



6. The maximum allowed size for uploaded files defaults to 2MB on Debian/Ubuntu. This is likely to be insufficient for large 
multimedia attachments, so you may wish to set this value higher. However, it must not be higher than the n 
POST size set above, otherwise large uploads may fail. 



7. You may also wish to disable automatic session garbage collection, which can cause permissions errors to be shown in 
the browser if your server runs Debian or Ubuntu. These GNU/Linux distributions use a cron job /etc/cron.d/php5 to 
perform garbage collection instead. 

session. gc_probability = 

INSTALLING THE ALTERNATIVE PHP CACHE 

This step is optional, but highly recommended for optimum Newscoop performance. On Debian or Ubuntu, you can install 
APC with the following steps: 

$ sudo apt-get install php-pear php5-dev libpcre3-dev 
$ sudo pear config-set php_ini /etc/php5/apache2/php. ini 
$ sudo peel config-set php_ini /etc/php5/apache2/php. ini 
$ sudo peel install ape 

During the peel install ape step, tap the Enter key when prompted to accept the default APC settings. Then restart 
Apache to enable the APC module. 



APACHE CONFIGURATION 

The Apache web server's configuration will need to be adjusted to set the path to the Newscoop files and templates. On 
Debian or Ubuntu, Apache configuration files are usually found in the /etc/apache2/sites-available/ directory. 

1. Create a file such as newscoop containing a virtual host definition. 

ale. com, you could use a virtual host definition like the following: 
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If the ServerName or ServerAlias that you are using is not yet set up in DNS for this particular machine's IP address, you 
can create a temporary hostname in your /etc/hosts/ file which will enable you to test the installation locally. 

2. Disable the default Apache configuration, if you aren't using it. 

$ sudo a2dissite default 
Site default disabled. 

3. Enable the Newscoop configuration that you just created. 

$ sudo a2ensite newscoop 
Enabling site newscoop. 
Run '/etc/init .d/apache2 reload' to activate new configuration! 

4. You may also need to enable Apache's rewrite module. On Debian/Ubuntu, you can do this with the a2enmod 
command: 



5. Restart Apache as suggested by the output of the command above, so that the Newscoop configuration and the 
modules can be loaded: 



The server should respond: 

* Restarting web server apache2 [ OK ] 

6. Extract the Newscoop tarball that you downloaded in your working directory. This action will generate a directory 
named 'newscoop'. 



7. Change into the 'newscoop' directory, and examine the contents with the Is command. 



The output of this command should appear similar to: 

ChangeLog COPYING CREDITS documentation INSTALL README src UPGRADE 

8. Copy the contents of the src directory into the DocumentRoot directory of the Apache virtual host that you set up, 
such as /var/www/newscoop/ 



9. Change the ownership of the DocumentRoot directory to the username of the web si 
Debian or Ubuntu. 



10. Open a web browser with the URL of the Apache ServerName or ServerAlias that you set up earlier. If you see the 
Newscoop installer page, you are ready to proceed through the installation steps. 



INSTALLATION STEPS 



At the URL of your publicatioi 
dependencies. 



n site, Newscoop should display a Pre-installation Check page indicating the 
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Next, you need to set the Server Name/Address for the database, which will be localhost if Apache and MySQL are 
running on the same machine. You only need to enter a number in the Server Port field if you are using a non-standard 
MySQL port. Then enter the User Name, User Password and Database Name that you set up earlier. 



mmum b&bu^ 


Progress... 








Pre-installation Check 

License 

Database Settings -f 1 

Main Configuration 

Sample Site 

Automated Tasks 


Se rve r N am eJ A ddre s s : 


localhost 


Server Port: (OpftmiaJ) 


User Name: 


User Password: 


fks 




( ) 


Database Name: 




newsccc.pl 





If you enter a Database Name which already e 
Database. Only click the Yes option if you are 



n the specified sen 
jre that any produ< 



, you will asked if you wish to Ov< 
■n databases are fully backed up. 



There is already a 



Server Name/Address: 
local host 



Server Port: (Optional) 
3306 



User Name: 

newscoop_user 

User Password: 



Database Name: 

newscoop 

Overwrite Database: 



Database Settings 
Main Configuration 
Sample Site 
Automated Tasks 




Next is the Main Configuration page, which is where you set the name of your first publication, as well as the password 
and email address for Newscoop's admin user. This user account is critical for management of your Newscoop 
publications, so make sure that you keep the password somewhere secure. 



mmsmium E39 


Progress... 








Pre-installation Check 

Database Settings 
Main Configuration * 
Sample Site 
Automated Tasks 
Finish 


Site Title: 

The Custodian 

Administrator Password: 








Confirm Password: 


%\ 


•••••••••••• 


/ V \ 


Administrator E-Mail: 


1 1 


Ui 1 M ^EB=!1TBI5H! 









Newscoop includes a demonstration public; 
template to work, you will need to set up 
template designed, or wish to start with ai 



tion template which you can use for evaluation purposes. For the demo 
Publication alias with your chosen ServerName later. If you already have 
empty template set, click the No, thanks! radio button. 



Please choose a demo template: '-' No, thanks! 











7/tf Custodian 9 






aMfflLas—- 


iiS 




|Sltfl " 









Pre-irsta 

Database Settings 
Main Configuration 
Sample Site * 
Automated Tasks 




The next page of the installer s 



ited maintenance tasks for your Newscoop server, using cron jobs. 



BEE3E31 


Progress... 








Pre-installation Check 

Database Settings 
Mail- Configuration 
Sample Site 
Automated Tasks <* 


Autopublish: Modifies the status of issues and articles scheduled far 
certain actions. 

Events Notifier: Sends emails to administrative users containing the 
latest events that took place in Campsite. 

Index er: Indexes the article :::: search engine 
database]. 


Subscriptions Notifier: Sends emails to subscribers alerting them 
when their subscription ends. 


^ 







Once installation has completed, two large buttons are shown. Clicking on the upper button, with a tools icon, redirects 
you to the Newscoop administrator interface. The lower button takes you to the Sourcefabric website, for further 
information and support on Newscoop. 





st ion Check 
License 

Database- Settings 
Main Configuration 
Sample Site 

d Tasks 
Finish ■* 
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GETTING STARTED 



Newscoop enables you to host multiple, multi-lingual publications on the same web server. The process of setting up a 
new on-line publication with Newscoop can be divided into three steps: 

1. Configuring the publication, and specifying the templates to be used 

2. Establishing the structure of your publication, with issues and sections 

3. Adding content, managing content, and publishing it 

This part of the Newscoop manual is aimed at editors and journalists working their way through these three steps. It 
assumes that the web server you will use is already up and running with Newscoop, and that templates have been 
designed for your publication. If you do not yet have your own Newscoop server running, you can follow the steps in th 
manual using the Newscoop demonstration server and sample templates provided by Sourcefabric. 



The first step begins with logging in to the administra 
which is only available to the staff of your publicatior 
home page of your website instead. 



i interface of your Newscoop s> 
eaders who subscribe to your c 



-. This 



a special interface 
on will log in using the 



By default, the URL you should ei 
followed by 'admin'. For example: 



o your web browser for the administration interface is the n 



http://w* 



mple.o 



n/admin/ 



If you installed Newscoop yourself, you would have set a password for the 'admin' user during the installation steps. If not, 
your system administrator should already have provided you with a login account name and password. Below the Account 
name and Password fields, click the drop-down menu to select an interface language other than the default of English, if 
you wish. Then click the Login button. 



Newscoop 



SOURCEFABRIC 



Login 



Password : 
Language : 

Forgot your password? 



I L0GIN J 



'ely, the Newscoop demonstration server can be found at: 

http://newscoop-demo.sourcefabric.org/admin/ 

Please remember that the demonstration server is a public site, so don't enter any private information there. A variety 
of guest login accounts are set up on this system, and the passwords for these accounts are shown on the login page. 



8. 



THE DASHBOARD 



After logging into the admin interface for the first time, you'll see an empty home page which Newscoop calls the 
Dashboard. This an area into which you can add widgets for the administration functions that you use most often. In 
this way, you can customize the administration interface to suit your needs. Click on the Add more widgets link to ope 
a page where you can select from more than a dozen potential widgets. 




n the Widgets page, click the Add to dashboard link for each widget that you would like to start with. You can refine 
>ur choice of widgets later, as you get to know the Newscoop administration interface and its functions. 



Widgets 








Most Popular Articles 

Add to dashboard 




Pending Articles 

Add to dashboard 
Admin articles 'widgets. 


Admin articles wicrtjets. 

Autiior 

5curcefabrico.ps. 

Veraor. 

1.0 

Homepage: 

License: 
GPLv3 


Sourcefabrico.p.s. 
1.0 

GPLv3 








Recently Published Articles 

Add to dashboard 
Ad mm articles widgets. 




Submitted Articles 

Add to dashboard 
Adrrti articles widgets. 


Author 

5ourcefabricc.ps. 

Veraon 

1.0 

Homepage: 

GPL«3 


Author 

Scurcefabrica.p.s. 

Veraotr: 

1.0 

GPLV3 



After all the widgets that you require have been added to the Dashboard, they change from black to green text to show 
that they are active. Click the Go to home link to return to the Dashboard. 



Widgets 








Most Popular Articles 




Pending Articles 

Add to dashboard 
Ad min articles widgets. 


Sourcefabrico.p.s. 

1.0 

Homepage: 
www.sourcBfabric.org 

GPLv3 


Author: 

Sourcefabrico.p.s. 

Veraon: 

ID 

Homepage: 
www.sourccfabric.org 

GPLv3 



Each widget has three small blue icons in the upper right corner. From left to right, these icons maximize the widget t 
the full width of your browser window, provide general information about the widget, or close it. When a widget is 
maximized, clicking the close icon returns the widget to normal size. 



>oard 


st Popular Articles 










;;rilx 














Author: W 




Stowing 1 to 53 of 53 entrie* 










Id 






o Name 


Type 


Author 


On Front 
Page 


On 
Section 


GPLv3 


fahric.org 




Making the Most of a 
Small Apartment 


News Article 


Staffwriter 


No 


Yes 


24 








•*[ Cruise to 
Raise Money for Local 
Charities 


News Article 


Arellanes 


No 


Yes 


41 



HOW PERMISSIONS CHANGE THE INTERFACE 



The appearance of the Newscoop administration interface changes, depending on the permissions that a particular staff 
member has. Each user sees only the options that he or she has the authority to use. A typical staff user (a section 
editor or journalist) will only see some of the options available to a fully authorized administrator (such as the publisher, 
or senior manager). 

When you log into the Newscoop administration interface, across the top of the page you will see the main navigation 
menu, containing the options available to you. Here is how two typical users would see the main menu differently. Firstly, 
here's how the Actions sub-menu looks when an administrator is logged in: 




' New; Article 



Author Status 

Sarah Staffwriter Published 

DouglasAtellanes Published 




10. 



MAIN MENU 



5wscoop menu contains a link to the Dashboard page and up to five sub-menus, depending on the 
of the user who is logged in. These sub-menus are Content, Actions, Configure, Users, and Plugin 

shown below are for an administrator user, who has access to all sub-menu options. 



CONTENT 

Here you can find the Publications on the server, reader Comments, the Media Archive, and the Search page for all of 
the articles in the Newscoop database. For each available publication, there are quick links to the latest three issues, and 
a full list of sections within each issue. In the screen shot below, a sample publication called 'the Custodian' has been set 
up, with two issues in both English and Spanish. 




ACTIONS 





USERS 

Here you can add and edit Staff users, and manage Subscribers. You can also define Staff User Types, or Synchronize 
Newscoop and Phorum users, integrating this web forum system with your publication's site. The Manage Authors 
page enables you to maintain contact and biography information for each of your publication's contributors, as well as 
track the articles that they have worked on. 




Most Popular Articles 



PLUGINS 

This sub-menu provides access to additional functionality for Newscoop, including Blogs, Interviews and Polls plugins. 



' E 



HELP AND LOGOUT 



Up in the top right corner of the administration interface are two additional links, to the right of the full name associated 
with your login account. Help links you to the on-line version of this manual, via the Sourcefabric website. Logout ends 
your session and returns you to the administration login page. 



11. 



CREATING A PUBLICATION 



Newscoop content is organized in a hierarchical structure, which conforms to the tradition of newspapers and magazines: 
Publications, Issues, Sections and Articles. Each publication is made up of issues; each issue is in turn made up of sections, 
which are comprised of articles. A 'breadcrumb trail' of links is present on every screen, which enables quick navigation 
between different levels of the publishing hierarchy. 

For example, after creating a publication named the "The Custodian", by clicking on "The Custodian" in Newscoop's list of 
publications, you enter the list of issues for that newspaper. By clicking the name or number of a particular issue, you 
enter its list of sections. By clicking the name of a section you enter the article list. By clicking the article title in that list, 
you can edit the article. 

To create a new publication, click Content on the main navigation menu, and then click 'Publications' from the sub-menu. 
On the Publication List page that appears, click on 'Add new publication'. 





















COTBT. > 




■§■ Addr 


euv publication 










Number 


££_« 


Default Site Alias 


Default Language 


Comments enabled 




' 


the Custodian 


newscoop-dev.sourcefabric.org 


Engiish 


• 



If your login account does not have administrator rights, you will not be able to see the 'Add new publication' option. You 
may need to ask your system administrator to enhance your access rights. Bear in mind, however, that a good 
administrator would be reluctant to hand over those rights to more than a handful of people. If you are not among those 
select few, your Publications List will only contain the publications already hosted on your Newscoop server. 

The Add new publication window has three sections; General attributes and Comments on the left, and Subscription 
defaults on the right. There's a Save button beneath these sections. 

The fields in the General attributes section are: 

• Name of the publication (e.g. "The Prague Times") 

• Default Site Alias is the name of the web server on which your publication will be hosted (e.g. www.example.com). 
Newscoop enables multiple publications to be hosted on the same web server, providing that a unique alias has 
been set up for each publication by your system administrator 

• Default Language sets the default language of the publication for readers 

• URL type selects between the display of full path URLs, or short URLs which are better for pasting into newsletters 
and social media posts 

• Search engine optimization helps your articles to be found on the Internet 

• Invalid URL Template allows you to specify the page that readers will see if they follow a broken or outdated link. 
For example, you may wish to help lost readers by leading them to a search page 

The fields in the Comments section are: 

• Comments enabled? Check this box if you would like your readers to be able to comment on articles 

• Article comments default to enabled? If you check this box, then article comments for any new article will 
default to "enabled" 

• Subscriber comments moderated? If you check this box, comments by subscribers will be hidden from readers 
until they have been reviewed by a staff member 

• Public allowed to comment? Check this box if non-subscribers will be allowed to make comments on articles 

• Public comments moderated? If you check this box, non-subscriber comments will be hidden from readers until 
they have been reviewed by a staff member 

• Use CAPTCHA to prevent spam? The reader must type in random letters or numbers shown before they can 

• Moderator address If comments are moderated, each time a comment is posted an email is sent to this address, 
such as 'editor@example.com' 

• From address is the sender email address shown on the email sent to the moderator, which should be a valid 



e of bounces. An address such a 



General attributes 

Name: The Prague Times 
Default Site Alias: : www.exairple.com 



: 



Default language: | Pesky 



31 Edit languages 



IType: [ 



■ 



• 



Search engine optim 

Invalid URL Template: | classicftpfeearch-box.tpl 



Article title 

Article keywords 

□ Article topics 



Comments 

Comments enabled?: 
Article comments default to enabled?: 
Subscriber comments moderated?: 
Public allowed to comment?: 

Public comments moderated?: 
Use CAPTCHA to prevent spam?: 
Moderator Address: 
From Address: 



editor@example.com 
robot@example.com 



SUBSCRIPTION DEFAULTS 



2 rest of the fields art 
t for your subscriptio 



elated to subscriptions, which you can adjust lat 
; which could be days, months, weeks or years. 



r if you wish. First, you have 



ou can set two types of subscriptions: paid and trial. Paid subscriptions have the following properties: 

• Currency: the subscription currency. Even if a subscription request is sent and the currency setting is changed 
before payment, the information about the subscriber's payment due is correctly recorded 

• Time unit cost per one section: 

o for one language: the price for access to a particular section in a single language 
o for all languages: the price for access to a section in all available languages 

• Default time period: the usual duration of the paid subscription. This value is used when a reader subscribes 
through the website. The period for a particular subscription can be modified from the administration interface 



Subscription defaults 


Time Unit: 
Paid subscriptions 


1 months ▼]! 


Currency: USD 

Time unit cost per one section: 


- one language: 


|l.0O | 






- all languages: 


|2.00 | 






Default time period: 
Trial subscriptions 


1 time units 


Default time period: 


1 j time Jnits 



After clicking the Save button, Newscoop will confirm that the new publication has been created. 



Content > Publication: The Prague Times ; 



^ Publication List Co To Issues ^ 




=8" Add new publication Q Delete 




Publication created. 





On the right hand side under the Subscription defaults fields, there will now be a link Set subscription settings by 

country which will enable you specify different default time periods for individual countries. 



Subscription defaults 


Paid subscriptions 


1 months ~\\ 


Currency: 


|USD 


Time unit cost per one section: 


- one language: 


|1.00 | 






- all languages: 


12.00 






Default time period: 


^^ time units 


Trial subscriptions 




Default time period: 


f^^t.me units 


Set subscriptio 


/.country 




b 



This link opens the Subscription Settings by Country page, which has a link Set subscription settings for a country. 



al s Libs c ription paid s ubsc r iption 



If you follow this link, it opens a page with a drop-down menu for selecting the country in question, plus fields for the 
default trial and paid subscription lengths. Clicking the Save button returns you to the "Subscription Settings by Country" 
page, which should now show the setting you have just made. 



12. 



CREATING AN ISSUE 



Once you have successfully created your publication, click on its name in the Publication List (e.g. "The Prague Times"). 
This will lead you to the Issue List, which will be empty to begin with. 



Content > Publication: The PracLe Time;. ; 



+ Set subscription settings for a 



3_ 



Country Default time period (months): 

trial subscription paid subscription 



Click on the 'Add new issue' link. If you a 
information which you will need to enter 


e creating the very first iss 


— "'" 


see a pag 


l^^^^^^^ 


Content > Publication: The Prague Times > l55L.es > 



page with fields for basii 



Add new issue 




Name: January 2011 




Language: Cesky 
Number: 1 


d| 


URL Name: 2011_1| 


IB 




Cancel | 



The Name is the name of the issue in the particular Language you specify in the drop-down box underneath. The 
Number is a unique identifier for this issue. If this is the first issue you've ever published, then number "1" would be 
appropriate. The issue number cannot be changed once it is specified. 

If you are planning to add older issues of your publication at a later stage to the same Newscoop server, you may 
consider continuing the series. For example, if you just published issue 154 of the "The Prague Times" before moving to 
Newscoop, you should assign number 155 to the first issue you are creating with Newscoop. 

The URL Name field is only useful if you specified the "URL type: short names" option when you created your publication 
This name will show up in the reader's browser address bar. For example, if you enter "2011J" here, the address for the 
issue might look like this: 

http://www.example.com/2011_l 

Clicking the Save button takes you to the Change issue details page, where various options for the issue are set. On 
the left hand side, there are settings for the default templates for the front page, sections and articles. If you do not 
have your own templates yet, you can select templates from the 'classic' demonstration set that are provided with 
Newscoop. Reader polls can also be set up and edited on this side of the page. 



Content > Publication: The Prague Times > Issue: Januay 2011 (Cesfcfl ; 
^1 Issue List Go To Sections fv 
+ Add new issue C^ Preview Lji] Translate Li Deli 



Change issue details 


Number: 

URL Name-: 
Language-: 

Publication date 
[yyyy-mrrnid): 

Default templates 


1 




[January 2011 


i 






2011_1 


i 






jcesky J 
Click hereto publish this issue 


Front Page Template: 
Section Template: 
Article Template: 






1 classic/inrJex.tpl 


4 






1 classicteection tpl 


4 






classicterticle.tpl 


4 


ca 





On the right hand side of the Change issue details page are boxes which enable you to set the publishing schedule for 
n be set to be published at a specific date and time, and unpublished at another date and time. 




Issue Publishing Schedule 






Date/Time Action 


Publish articles 


Delete 


2011-01-17 16:00:00 Publish 


Yes 


□ 


2011-02-17 16:00:00 Unpublish 


Yes 


□ 



Publish articles: 



Date: [2011-02-17 ~| H 
Time: [is] [so] : 
Action: | Unpublish j| 

Si 



-flU 



COPYING A PREVIOUS ISSUE 



If this is not the first issue you've 
List: 



a different page after clicking the Add n 



a link in the Issui 



Content > Public 



i: The Prague Times > Issues ; 



D Use the structure of the previous issue 




Copy the entire structure in all languages from the previous is 
You may modify it later if you wish. 


ue except for content. 


D Create a new structure 




Create a complete new structure. 

You must define an issue type for each language and then se 


tions for them. 



"Use the structure of the previous issue" will be the usual option to choose once you are ready to publish additional 
issues, because it automatically creates a new issue with the same sections as the preceding one. Clicking this option 
opens a page which enables you to specify the new issue number. 



' 




The sections of the new issue will be empty, so that you can begin to add articles. Before that, the first step is to set th> 
name of the new issue, because this field is not automatically updated: it will start out with the same name as the last 
issue. After changing the Name and URL Name fields, click the Save button to update the new issue. 



Content > Publication: Trie Prague Times > Issue: Januay 2011 (Cesfcfl > 
^1 Issue List Go To Sections ^* 
+ Add new issue C^ Preview LiJ Translate Li Delete 



Change issue details 


Number: 

URL Name: 

Language: 

Publication date 
Cffly-mrrndd): 

Default templates 


2 




February 2011 


i 






2C11_2| 


i 






Cesky J] 
Click hereto publish this issue 


Front Page Template: 
Section Template: 
Article Template: 






classicyindex.tpl 


4 






clas'ic.-iection.tpl 


4 






1 classic/article.tpl 


4 


Ea 





e&& 



The previous templates are not copied to the n 
template for the front page. 



t be linked to at least a 



13. 



CREATING A SECTION 



the Section List. At first, a 




If you click on the 'Add new section' link, you will see the corresponding page appear. Here you must specify the Name, 
section Number, and URL name for the new section. While you can change the name of the section later, the section 
Number is set at the time when the new section is added. The URL name will be part of the URL for the new section, if 
you set the "short names" option when you created the publication. 



Content > Publication: The Prague Til 



:: January 2011 fCesky) > Sections 



Add new section 






Name: 


Property 


Description: 


The hottest real estate deals in Prague 


Number: 
URL Name: 


m 


Subscriptions: 


2 Add section to all subscriptions. 



The section Description is optional. This field is useful for displaying content that doesn't change very often. The 
information in this field will only be displayed on your site if the template you are using supports it. If you would like to 
make the new section available to all existing subscribers, you should check the box for this option. Then click the Save 
button. 



Your n 






t the templates for the n 



n the Configure Section page. 



Configure section 


Number: 


1 


Name: 


Property 


URL Maine: 


i 






Subscriptions: 


4 


Description: 


The hottest real estate deals in Prague 


Default templates 








Section Template: 


classic/section.tpl t| 


Article Template: 


classic/a rfjcie.tpl ; - 

Eg 



Here, you may wish to select custom templates for this n 
don't have custom templates for specific sections, you cai 
the Save button to confirm your choice. 



articles from the drop-down menus. If you 
in and article templates instead. Then click 



14. 



CREATING AN ARTICLE 



The Article List for a particular section can be found by clicking on Content in the main Newscoop navigation menu, and 
following the hierarchy of Publications, Issues and Sections. Alternatively, use the 'breadcrumb trail' of links just below the 
main navigation menu. You can create a new article by clicking the 'Add new article" link at the top of the Article List. 



Content > Publication: The Prague Times > Issue: January 2011 (Cesky) ;■ Section: Property ; 
4| Section List ■§■ I 

r— Select action 



The "Add new article" page contains three fields for entering basic information about the article you will create. 




Add new article 




Name: Librarians 


_ove Loft L 


ving| 


Type: News Article 
Larcjuatje: Cesky 


s^a 



• Name: The title of the article. You will be able to rename the article at any time in the future 

• Type: Select one of the available article types from the drop-down menu. If you have not set up any article types 
yet, only the default of "News Article" will be available. The choice you make at this stage cannot be altered 

• Language: Select the language the article will be written in. A drop-down list will contain the additional languages 
you have defined for this publication, if any. The language choice you make at this stage is final, although you can 
create a translation of the article into another language later 

When you click the 'Save' button, you will be taken to the Edit Article page. 



15. 



EDITING AN ARTICLE 



The appearance of the Edit article page depends on the article type you are working on. Below, the default "News 
Article" type is shown. At the top right are the Edit and View buttons, the Save All and Save and Close buttons, and 
the Actions, Status and Language drop-down menus. 




| Edit | | View | 



k'" 



~J| Language |cesfcj J] 



Edit, View and Save buttons 



There may be times when you want to view articles rather than edit them. In this case, clicking the View button speeds 
up the page display process. It also enables you to view an article when it is locked by another user on the server. Once 
the article is published, there will also be a Go to live article button here. 

Save All saves the fields in the edit area without closing the page, whereas Save and Close both saves the page and 
closes it, unlocking the page for other authorized users to edit further. 

Actions menu 

The Actions menu contains short-cuts to commonly used functions: 

• Unlock: When you begin editing an article, you automatically "lock" it to prevent conflicting edits from other users 
on the server. Using the Unlock option means that other authorized users can edit the article again 

• Delete: Removes the article permanently from the Newscoop server 

• Duplicate: Copies the article to any publication, issue, or section on the same Newscoop server 

• Translate: Creates a new copy of the article for translation into another language 

• Move: Moves the article to another publication, issue or section on the same Newscoop server 

Status menu 

The status drop-down n 



u indicates the copy flow state of the article. There are four s 



s that the article c 



i be ir 



• New: The article is still being written. Once the contributors are ready for the article to be seen by the editor, they 
should change the status to "Submitted" 

• Submitted: The article is under review by the editor or editors. Once the editors decide that the article is ready 
for the public to see, the status should be changed to "Published", or scheduled for publication at a later date and 

• Publish with issue: The article will be published only when the issue it belongs to is published 

• Published: The article belongs to a published issue, and is now viewable by the public 



Language menu 



If multiple languages have been configured for the publication, a drop-down menu will enable fast switching betW' 
translated versions of the article. If not, the language of the article will be displayed here. 

THE EDITING AREA 

To the left of the Actions and Status drop-down menus is the editing area for the article. 



Content > Publication: Tie Prague Times > Issue: January 2011 (Gesky) > Section: Property > Article: L 

Librarians Love Loft Living $ 



Author 


' 


Jane Q. Reporter 




Photographer 


' 


James Q. Photographer 



♦ 

« 



D?.w 

Created: 2011-01-17 16:17:44 Q Last modified : 2011-01-17 16:17:44 

Deck 



As long as there are shelves, they're happy 



Lead and SMS 
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*f « 1 ^ x 1a &a ® I *> c in ia *• il 
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Librarians are snapping up apartments in convi 


rted warehouses. There's more space fer books, they say. 



The "News article" type has the following fields in the editing area: 

• Name: The title of the article 

• Author: This drop-down menu enables you to credit multiple contributors, including Author or Writer, Photographer, 
Editor, and Columnist. Type the contributor name in the box to the right. Click the + icon to include additional 
contributors, or click the x icon to remove them 

• Date: Since this field can order the way your articles are displayed to readers, you can change this date if you 

• Deck: a sub-heading or article teaser 

• Lead and SMS: a short version of the article, suitable for sending via a text message gateway to phones which 
support the Short Message Service. The length of an SMS text message depends on the alphabet used, from a 
maximum of 70 characters in Chinese or Cyrillic alphabets, up to a maximum of 160 characters in the Latin 
alphabet 

• Body: the main section of the article 

COMMENTS 

Beneath the editing area, there's a box in which you can set reader comments on the article to be enabled, if you wish. 
Your templates must be designed to allow this feature. The radio buttons can have one of three values: Enabled, 
Disabled, or Locked. "Locked" means that no one can post comments, but any existing comments are still shown. Click 
the blue Comments link to minimize the box, saving space in your browser window. 



i> Enabled O Disabled O Locked 



® New O Approved O Delete C 



From 


Daniel James 






Date 


2011-01-17 17:27:59 






Subject 


1 never have &iiou:ih i 


om for books 




Comment 


1 too would love to hav 


e a loft apam i 


ts of shelves... 


Reply to comment 



Post a Comment 

Author 



Submit 



Individual comments can be Approved for publication, Deleted or Hidden, using the radio buttons immediately above. 
Beneath the displayed comments is a form which staff members of your publication can use to add a comment of their 
own, perhaps in reply to a reader question. 

THE SIDEBAR 

On the right side of the editing area is a vertical bar containing further options for the new article, in a series of boxes. 
Like the Comments box, all of the boxes in the sidebar can be minimized by clicking on the blue link in the box name. 

Publish Schedule 



Schedule the article to be published or unpublished at a certain date and tin- 
window with a calendar and publishing options, such as showing the article o 
homepage. 



. Click the Add Event button to open a 
its section page, or the publication's 



,11 Apartment (English) ; 



| Edit | | View | 



Saved 16:43:42 



.. _rj| I Status: Submitted jl 



Language [English -J 



2011-01-13 16:59:00 

• Publish 

♦ Show on 



Clicking the Edit button in the Locations box opens a pop-up window which enables you to set a geolocation (map 
reference) for the article. 
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Content > Publication: The Prague Times > ! i ,:■ Section: Property > Article: I 



mans Love Loft Living 

Librarian Loft Locations 



I Czech Republic 



c 



he 




d Map View 




Keywords & Topics 

• Keywords: Enter words that describe your article to search engines 

• Topics: Select from a list of topics and subtopics defined by your Newscoop administrator by clicking on the Edit 
button, which opens a pop-up window. Topics allow you to set attributes for the article, which may be used to 
display the article in a certain way 



- D Wurzel 

* D Weather 

- D Cars 

D People In The News 
D Features 
+ □ Funny 

- D Fashion 
D Geography 

- D Local Sports 
D Olympics 

+ □ Safety 

- D Business 

D Breaking News 
+ D Entertainment 

- D Accidents 
+ □ Agriculture 
+ □ Local News 

- □ Crime 

4 □ Politics 

+ □ News You Can Use 

- Real Estate 

Apartments 

□ Real Estate Brokers 
Buying Real Estate 

□ Selling Real Estate 
Hot Properties 



After clicking the Save and Close button, the Topics you have selected are displayed in the box in the sidebar. 



•» Keywords & Topics 




Keywords 


loft, apartment prague 


l-l 




Topics 


1 Real Estate 


• 




1 Real Estate 1 Apartments 


13 




I Real Estate 1 Buying Real Estate 


33 




1 Real Estate / Hot Properties 


33 







D Show article on frontpage 
Show article on section page 
Visible to ni 



• Show article on front page: Check this box if you want the article to be displayed on your publication's homepage 

• Show article on section page: Check this box if you would like the article to be displayed on the relevant section 
page 

• Visible to non-subscribers: Check this box if you want to make the article visible to readers who have not yet 
subscribed 



▼ Info 


Reads 




27 


Type 




News Article 


Number 




5 


Created 


>y 


Administrator 



• Reads: A number indicating the popularity of this particular article. An article which has not yet been published v 
display N/A here 

• Type: Refers to the "article type", i.e. the format of the article. You cannot change this field once it has been 
assigned 

• Number: The article's unique identification number 

• Created by: the name of the Newscoop user who created this article. You cannot change this field 



Media 

The Media box has t 



tabs, Images and Attachments. 



Images 



• Images: You can attach images to your article which can be included directly into an article body field, or used ir 
the template 

• Attachments: You can attach any kind of file you wish to the article. The article template must be set up to 
display these files, if users are to have access to them 



| + Attach | 



Fsvotuite CMS [English) 



The Polls box enables you to add a specific reader voting poll to a specific article. Clicking the Attach button open; 



pop-up window in which you can select the poll that you require. You can also create a new poll there. 

Other article types may contain different fields. Whenever you edit any of the fields, you will need to click either the 
Save All button at the top of the edit area, or any of the Save buttons in individual boxes. 

Note that date fields have a fixed syntax of YYYY-MM-DD (four year digits, two month digits and two day digits, in tha 
order). If you enter dates in any other format, you may get ir 
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USING THE TINYMCE EDITOR 



The body field editor in Newscoop (a program called TinyMCE') allows contributors to perform extensive article formatting 
from within a web browser. You may be familiar with most of the functions of TinyMCE from using word processors such 
as Microsoft Word or OpenOffice.org: functions such as bold, italic, underline, and text alignment. Move your mouse over 
the icons to see a tooltip explaining what they do. Standard formatting keyboard shortcuts also work (e.g. ctrl+b for bold, 
ctrl+i for italic). 
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ht„l a — A - V ~ X, x' | » *S I \= i= I SM« ~ Paragraph - fimttar* ~ Resize - 
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The editor field you see on your own Newscoop installation may look different than the one pictured above, depending o 
the extent of your user rights. Typically, the editor you'll see is the one that contains all the functionality you need for 
your site, but if you feel something vital is missing, discuss it with your Newscoop system administrator. 



There are two Newscoop-specific features in the editc 
links to articles within the same Newscoop publication 



. The first is Insert/edit 
or within another publica - 



il link, which allows you to include 
the same Newscoop server. 



fell ! n li 

Paragraph ■*■ Fori' 



I j, *# uJ B 



Clicking this ic 



a pop-up window with drop-down n 
>n and article to link to. 



labling you to select a specific language v 



® " - • - : QM 



f\ http://newscoop-dev,sourcef abric.org/master/javascript/ 



Language 
Publication 

Se:tbn 

£rt::!e 


p 






| Enqish _»J 

| the Custodian _»J 

^T3 


| Real Estate _-J 


| Home Prices Rise 1.1% in 3 it Quarter 


H 






[ Open in new window Lbiankj 




a 









After you click the Insert button, the internally linked text will be shown in blue and underlined, like a web link. 
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^l ? 
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The second Newscoop-specific feature is Newscoop Subhead, which allows you to break your text into different pages. 
(Your templates must be configured to use this option). 



SI-JO" 
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«1» # Hj B 


Paragraph 


- Font family 


- ForTslft 
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Enter the text for the subhead into the editing window, select it with the mouse, then click the Newscoop Subhead ic 
The subhead text will now be shown with a dashed outline. 
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! Example subhead; 
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MANAGING CONTENT 



The "Article List" page is displayed when you enter a particular section via the Content menu, by following the hierarchy 
of publications, issues and sections. Alternatively, use the breadcrumb trail to jump to the section that you're interested 
in, and then click the "Go to Articles" link. 



Content > Publication: the Custodian > Issue: 


issuel (English) > Section 


Real Eslide - 




Article List: Real Estate 




^ Section List #■ Add new article 




















I" 




3 
















Searc 




1 






*t_Z 




j 1 to 5 of 5 entries - filtering from 102 r 




















□ 


s 


Type 


Author 


Sta 


D 
□ 


Making the Most of a Small 
Apartment 


News Article 


Sarah Staffwriter 


Publisr 


Real Estate Agency Celebrates 
5Cr.ii -nniversary 


News Article 


Douglas Arellanes 


Publisr 


D 
D 


Open House at Fairfield Mansior 


News Article 


James Q. Reporter 


Publisr 


Local Neighborhood On The 
Comeback Trail 


News Article 


Douglas Arellanes 


Publisr 



To edit a specific article, simply click on its Name, and you will be taken to the "Edit Article" page. A locked a 
that is being edited at that moment, as shown in the list by a pink background and a padlock icon to the left < 



Search 




unfe 






cz 




1 to 5 of 5 entres - filtering from 102 ret 












□ 


o 


Type 


Author 


Status 


□ 


a : '.'• 1 1 c | the Most of a Small 
Apartment 


News Article 


Sarah Staflwriter 


Submitted 


□ 


S Real Estate - - Celebrate 
50th Anniversary 


News Article 


Douglas Arellanes 


Publish with 


□ 


. 


News Article 


James Q. Reporter 


Publish with 


□ 


- 
Comeback Trail 


News Article 


Douglas Arellanes 


Publish with 


□ 


Hore Price; Rh:e l.lVs in 3rd 
Quarter 


News Article 


Douglas Arellanes 


Publish with 


Shying 


1 to 5 of 5 entries - filtering from 102 records 














Display 


10 ^j records 





To find out who is editing an article and when it 



s locked, click on the article Name in the list. A page will open with the 

51 



6 of the editor, and buttons offering the options of unlocking or viewing that particular article. Using the View optioi 
ns that you will not be able to overwrite another contributor's work while it is still in progress. 



> Issue: issuel (English) ;■ Section; Cars > Article: AugLil :-. 



Article is locked 

The article has been locked by Petr Jasek [petr.jasek] 28 minuter; : ago 
Unlock I I Cancel 



I 



MULTIPLE ACTIONS 



The Article List allows you to perform other actions besides editing the article, and you can perform these actions 01 
multiple articles at once. To perform an action on one or more articles, click the checkbox to the left of the article n 
The articles you have selected will be highlighted with a light blue background. 





Showinc 




ccr = 5 










1 to 5 of S entries - filtering from 102 re 
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Type 


Author 


Status 





Making the Most of a Small 
Apartment 


News Article 


Sarah Staffwriter 


Published 





Real Estate Agency Celebrates 
50th Anniversary 


News Article 


Douglas Arellanos 


Published 


m 


Open House at Fairfield Mansion 


News Article 


James Q. Reporter 


Published 


□ 


Local Neighborhood On The 
Comeback Trail 


News Article 


Douglas Arellanos 


Published 


□ 


Home Prices Rise 1.1% in 3rd 


NewsAricie 


Douglas Arellanos 


Published 


Showing 


1 to 5 of 5 entries - filtering from 102 records 














Display 


^Q records 









Now that you have selected the articles, { 
action you would like to perform: 



o the "Actions..." drop-down rr 



t the top of the list, and select the 



To:i:ils On '■-:: ~- 
l onments 1 
Schedule 

J Delete 
Duplicate 
Duplicate to another section Type 

News Article 

News Article 

Ope* ■ : -:■ i a 1 1 NewsArticle 

n Local Neighborhood On The NewsArticle 

u Comeback Trail NewsArticle 

D Home Prices Rise 1.1« in 3rd NewsAmde 



Author 


Status 


Sarah Staffwriter 


Published 


Douglas Arellanes 


Published 


James Q. Reporter 


Published 


Douglas Arellanes 


Published 


Douglas Arellanos 


Published 



Stowing 1 10 5 of 5 entries - filtering from 102 records 



10 T 



For example, if you select "Toggle: 'On Front Page'", Newscoop will publish the selected articles on the front page of 
your publication. A small green pop-up window will confirm that the action has been processed. Some actions will take you 
to another page, because they require further input from you. These actions requiring additional input include Publish 
schedule, Duplicate to another section, and Move. 

The article list also allows you to rearrange articles as they appear on your section page, if your template supports this 
feature. To move an article's position in the list, simply click anywhere in it's row, hold the mouse button down, and drag 
the row to the position that you require. The new arrangement of the articles is not finalized until you click the Save 
order button underneath the Article List. 



On the right hand side of the Article List are additional columns which relate to other functio 
comments posted on the article, or the number of readers it has had. In the upper right corr 
hide columns button which enables you to select the columns that you wish to view. 

SEARCH 



sthe 






Newscoop includes another tool which provides an overview of content across all publications on the server. The Search 
feature is accessed via an entry on the Content menu, and has an interface somewhat like an Internet search engine. You 
can filter the search options according to a specific publication, issue or section. You can also filter by a number of other 
criteria, such as the author or publication date of the article. 



All Publications 



Publish date 
Published after 
Published before 



_^J | All Issues - 



13 \E 



Stowing 1 to 60 of 60 entries - Altering from 10B records 



Type 

News Article 



Douglas Arellanes 
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PUBLISHING ARTICLES 



As mentioned previously, an article in Newscoop can have one of four different states: New, Submitted, Published, o 
Publish with issue. When you create an article, the Status: drop-down menu at the top of the editing area is set to 
New by default. Once your article copy has been drafted and is ready for the editors to see, click on this drop-down 
menu and change the Status: to Submitted. 






I Actions... tJ| 


Status: New ij 


Language 1 English t|| 


Status: Published 


» Locations 


blr.lilMl^llilnHiiJtlB 

Status: New 1^ 




F^ 



After changing the status to Submitted, the page will be reloaded, and a pop-up message will indicate that the change in 
status of the article has been saved. The editors will be able to see the fresh submission when they log in to Newscoop. 
Articles which are ready for editing are listed in the Submitted Articles view on the administrator Dashboard. 




Submitted Article* 



Type 

News Article 



".vriter Submitted No 



In addition, if their user accounts have been configured for notifications, an email will be sent to the editors to inform 
them about the new submission. 

Once the editors have made any required changes and are happy with the way the article reads and appears, they can 
publish the article by changing the drop-down Status: menu to Publish with issue. Again, the page will be reloaded, and a 
message will indicate that the article's status has changed. 



I Edit | | View | 



Actions... ^rjl 


Status: Submitted 


'!' 


Language 1 English ^J 








•r Publish Sc 




Status: Submitted w 
Status: New 






1 + Add Event 









When an article status is set to Publish with issue it becomes visible on your public web site, as soon as the issue it 
belongs to is published. This feature enables co-ordinated publishing of complementary articles when a complete issue is 
ready for the public. You can check the publication status of a particular issue in the Issue List. If the issue in question has 
already been published, then new articles can be seen by the public immediately after their status is changed to Publish. 



The process is fully reversible, so you can unpublish articles on your site (or even change their status to Nev 
you can publish them. Note that only authorized users are allowed to publish articles, so you will not be able 
this option if your system administrator has not granted you this permission. 



SCHEDULED ARTICLES 



You also have the option to publish (or unpublish) an article at a specific date and time in the future. You can do this from 
the Edit article page, using the Add Event button in the Publish Schedule box. 






1 Actions... _^J 1 Status: Submitted _»] 


Language 1 English t|| 


«■ Publish Schedule 


IEBI 





After clicking on Add Event, a pop-up window will appear with a calendar and a series of three possible actions for the 
date and time that you choose: Publish/Unpublish, Show on front page/Remove from front page, and Show on section 
page/Remove from section page. 



-1 (English.) . Section: f 



Schedule a new action 


Date: 

Publish: 

Front page: 

Section page: 

E 






1 2011-01-20 Q 
0:@ 
Actions 


| Publish Jl 


1- 


4 






Show on sectior p?.:is 


dl 


["close | 





Choose the date by clicking on the calendar, or enter a date code manually. Then enter the time for the event, and 
choose one or more actions to perform at the time you have chosen. After you click the Save button, the pop-up window 
will close, and the event will appear in the Publish Schedule box. 




3[ 



Status: Submitted , 



' Publish Schedule 



Language [English ^J 



2011-01-20 13:55:00 

• Publish 

• Show on section page 



Once the event is created, the actions will be performed automatically for you on the date and at the time you specified. 
After the event time, the Status drop-down menu will change to Published, and the event will no longer be shown in the 
Publish Schedule box. 
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PUBLISHING AN ISSUE 



You can draft and edit articles for a particular issue on your Campsite server without any of the material being available 
to the public. You can then publish an entire issue all at once, and there are two ways to do it: immediately, or by 
scheduling the issue to be published at a specific date and time in the future. Note that within an issue, you can publish or 
unpublish each article individually; for instance, to hide an article even if the issue it belongs to has already been 
published. 



PUBLISHING IMMEDIATELY 



To publish an issue straight away, click the Publish link for the rele\ 
n of the Issue List. 



and language edition in the Publish Date 






Issue L 

^ Publ 


1st 














cation List + Add new issue 












Number 


™.««« 


URL Name 


Publish Date 

(YYYY-MM-DD) 


Configure 


Translate 


Previev 


2 


issue2 [English) 


iS sue2 


Not published 
Publish - Schedule 
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■ 


Q 


2 


n urn era 2 (Espanol} 


nurmero2 


20KM9-27 09:14:15 
Unpublish -Schedule 


% 


sa 


Q 


1 


issuel [English) 


issuel 


2009-03-27 15:54:37 
Unpublish -Schedule 


% 


in 


Q 


1 


numeral [Espanol) 


numeral 


2010-09-27 09:14:39 
Unpublish -Sche 


% 


■ 


Q 



A pop-up dialog will ask you to confirm that you want to publish the issue in question, because this action implies that any 
articles which are part of the named issue will become available to the public instantly. 



<8' 


■■_s-i ?.; ■ '. ■ .;.; ,; =.-.-...; ;-.;; i ':..; ' ; ; . ; ; 




hi 


♦ 


Are you sure you want to change the issue 2. issue 
(English) status from "Not published" to 'Published'" 






Cancel 1 


<3ok 


| 









After clicking the OK button, the is 
time of that particular issue. 



e will be published, and the Issue List will be updated with the publication date 



Content > Publication: the Custodian 



Issue List 

^ Publication List * Addns 



Number Name 






i:uie2 (English) 

ni]rnero2 [Espafiol) numera2 

issuel [English) issuel 

numerol [Espafiol) numeral 



[YYYY-MM-DD) 

2011-01-20 15:54:01 
Unpublish -Schedule 
2010-09-27 09:14:15 
Unpublish- Schedule 
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Unpublish- Schedule 
2010-09-27 09:14:39 

Unpublish -Schedule 



Configure Translate Preview 
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w 


a 


% 
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To reverse the process, click the Unpublish link. Again, a pop-up dialog will ask if you are s 
issue's status. 



SCHEDULED PUBLISHING 



To schedule an issue to be published automatically at a specific date and time in the future, click on the Schedule link for 
the issue and language edition you require in the Publish Date column of the Issue List. This will open the Change issue 
details page, where you can set the date and time for this particular issue to be published. Over on the right hand side of 
the page are the Issue Publishing Schedule and Schedule a new action boxes. 

Issue Publishing Schedule 



Date/Time Action Publish articles Delete 


No events. 








Schedule a new action 




Date: 






1 2011-01-20 | £_) 
0:0 




'Publish Ujl 





-HL 



Click the small calendar icon to the right of the Date: field to select a specific day for publication. Set the time you 
require, and select either Publish or Unpublish from the drop-down Action menu. Then click the Save button. The Issue 
Publishing Schedule box will update to display the newly scheduled action. 



Issue Publishing Schedule 


Date/Time Action Publish articles Delete 


2011-01-20 16:15:00 Publish Yes EH 






Schedule a new action 






Date: 2011-01-20 | Q 
Time: [17] : |"oo] 
Action: — _^J 
Publish articles: \ Yes z\\ 
Save ] 







Note that you can also set the issue to be unpublished at a specific date and time in the future as well. This e 
displayed in the Issue Publishing Schedule box. 



Issue Publishing Schedule 








Date/Time Action 


Publish articles 


Delete 




2011-01-20 16:25:00 Publish 


Yes 


u 




2011-02-20 16:25:00 Jnpublish 


Yes 


□ 













To cancel a scheduled action, click the corresponding white 
asked to confirm the deletion. 



n the Delete colur 



1 




♦ 


Are you sure you want to delete this scheduled action? 


| ©Cancel 1 <3oK 



If you click on the Date/Time link for a future event, the Issue Publishing Schedule page will open, and you will be able 
to edit the event. Click the Save button to confirm the schedule change. 



Content > Publication: the Custodian > Issue: 


numouZCBpBnDO > 


Issue Publishing Schedule 




^ Issue List ^ Issue: numeroZ 






Edit 


Date: 2011-01-20 | Q 




Time: [le] : [~5oj] 






Action: Publish J] 






Publish articles: | Yes j| 






E^ 
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ARTICLE COMMENTS 



article. You 



from subscribers, 



n be switched on and off for a whole publication, for a particular article type, or for each individual 
take advantage of Newscoop's management features to moderate (or bypass moderation for) 
members of the general public. 



COMMENT SETTINGS IN THE PUBLICATION LIST 



To set the default comment setting at the publication level, go to Content on the main navigation menu, and then click 
Publications. In the Comments enabled column of the Publication List page which appears, publications in which readers 
can post comments are shown with a green light icon. Click on the Configure icon for the publication you wish to enable 
or disable comments for. 




Default Language Comments enabled URL Type Configure Delete 



This action opens the Configure publication page. In the Comments section, there is a checkbox labeled Comments 
enabled? and a variety of options which enable you to fine-tune comment settings. 



Comments enabled?: 

Article comments default to enabled?: 

Subscriber comments moderated?: D 

Public allowed to comment?: 

Public comments moderated?: 

Use CAPTCHA to prevent spam?: 
Moderator Address: 



From Address: 



COMMENT SETTINGS FOR ARTICLE TYPES 



Perhaps you want to enable comments for all articles of a particular type, for exar 
them for another type, such as news_article. Click Configure in the main navigatio 
from the submenu. On the Article Types page which appears, clicking the red or gr 
enabled? column toggles the setting for each article type. 



le review_article, but not enable 
nenu, and then click Article Types 
n light icon in the Comments 



Configure > 








Article Types 




=3= Add new article typ 


i^f Merge types 


C^ Show display nam 






Template Type Name 


Fields Display Name 


Translate Show/Hide 


Comments enabled? 


news_article 


Fields News Article (en 


P • 


1 


review_article 


Fields review_article 


P • 


• 













After you click on a green light icon, you will be asked if you are sure you want to deactivate comments for that article 



Are you sure you want to deactivate comments for article 
type 'news article"? 



[Q Cancel | <$9oK 



COMMENT SETTINGS FOR INDIVIDUAL ARTICLES 



Comments can be enabled or disabled for a number of individual articles at once, using the Article List page. Click 
Content on the main navigation menu, then use the submenus to navigate to the publication, issue and section that yoi 
require. In the Article List page that appears, use the checkboxes in the left side column to select the articles you want 
to enable or disable comments for. Then use the drop-down Actions menu and click on Toggle: 'Comments'. 



: ••■.•■ Publication ■ - . ■ ■• le-tue ■ _ = ■ Section: Res.! Estate 



Article List: Reed Estate 

•^ Section List ■§■ Add new article 



Status: Publish 
Status: Submit 
Status: Set New 
Toggle: 'On FrontPage' 
Toggle: 'On Senbi Fscr 

Scbedule 
Unlock 
Delete 

I Duplicate 
Duplicate to another section 

5 

LJ Apartment 



Open House at Fairfield Mansion News Article 
News Article 
News Article 
ig 1 to 5 of 5 entries - filtering from 101 records 



Sarah Staffwriter 


Submit 
Publist 


James Q. Reporter 


Publist 


Douglas Arellanes 


Publist 



DouglasArellanes Publist 



If the publication or article type that the articles belong to havi 
individual articles will have no effect. 
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MODERATING COMMENTS 



To prevent spam or defamatory posts from appearing in your online publicatic 
comments from readers before they are published. A CAPTCHA can prevent : 
prevent spam being entered into your publication's comment form manually. 



s often necessary to moderate 
automated spam, but it cannot 



Comments 
Your comment 

Your 



(mandatory): | A .N. Other-reader 



Your e-mail (mandatory]: f^ n@examp|exo ~ 
Comment subject: 






Comment text 



[l told y 



A cork on the end of the foil, 
that's the only way to make 
fencing safe, 



Enter the code: 



Send comment N 



[cuxix| 



If you have configured your publication so that subscriber or public comments are moderated, the n 
message indicating that their comment has been sent for approval before it will be published - or nc 



Comments 
Your comment 

Your comment has been sent for approval. 

Your name (mandatory): I 
Your e-mail (mandatory):! 
Comment subject: [| to | u you so! 

Comment text 




The list of reader comments can be found by clicking Content, then Comments, on the main navigation menu. On the 
left hand side of the Comments page are two tabs; one for New comments, and one for Published comments. The New 
tab is the default, and beneath this any new comments are listed. The default list length is 20 comments per page. There 
is a Search field to help you find a specific set of comments, perhaps on a topical subject. Search results can be sorted 
by Date posted, Article name, Author or Thread, using the drop-down menu to the right of the Search field. The sort 
direction can be changed by clicking on the blue arrow icon next to the drop-down menu. 

64 



Comments 


New[1] Published (2) 












Items per paae:|^oJ |_ 


Search: 


Date posted - JJ, 


Search 


Date posted Subject 


Article 














1 2011-01-20 17:31:08 1 to Id you 


Freak Fencing AcckJe 


t Causes Calls for Greater 


Safety in ^ 


® 
Article: 
(±^Sho 



On the right-hand side of the Comments page i< 
under review, as indicated by the small yellow ar 



a displaying the text and metadata of the c 



• 



O Approved Q Delete Q Hidden El Ban u 



I a™ I 



Article: Freak Fencing Accident Causes Calls for Greater Safety in Sport 

@^Show article 

Date: 2011-01-20 17:31:03 

Author: A. N. Other-reader <an@example.c< 



,«,«. 



in the end of the foil, that's the only way to n 



A row of radio buttons above the comment text enable you to update the New comment's status to Approved, or 
Delete if it is spam. Alternatively, the comment can be Hidden, or click Ban user to the user that made the comment 
banned from commenting on the publication in future. Clicking the Show article link, next to the magnifying glass icon, 
enables you to see the comment in the context of the original article. You can also click on the Article name link to open 
the Edit article page for that particular story. 
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22. 



SYSTEM PREFERENCES 



The System Preferences page is accessed via Configure in the main Newscoop navigati 




Add more widgets 



i : .,ilar Articles 



Stowing 1 to 53 of 53 entries 



Article Types 
Languages 



This page allows you to control some advanced aspects of your Newscoop s< 
reserved for administrators only. 



GENERAL SETTINGS 

The first section of the System Preferences page is for General Settings. 



mmended that access is 



System Preferences 



General Senings 

Site On-Line: 

Site Title: 

Site Meta Keywords: 

Site Meta Description: 

Time Zone: 

Database Cache Engine: 

Template Cache Handler: 

Image-cache Lifetime: 

Allow password recovery: 

Secret Key: 

Session Lifetime: 

Keyword separator: 

Number of failed login attempts before showing CAPTCHA : 

Maximum upload file size: 

Enter a value between and 2M (the maximum size is specified 
in 'php.ini). Please use 'K' for kilobytes, 'M' for megabytes and 'G' 
for gigabytes, without white spaces between the value and the 
corresponding letter, e.g. '3M'. 

SMTP Host: 
SMTP Port: 



Newscoop. Sourcefabric. 
Newscoop -The open coi 



I 11 ** dl 



E 



1400 

□ 



, 



Here is what each of the options means: 

• Site On-Line: These Yes and No radio buttons enable you t 
example in case of scheduled server maintenance 



• put the whole Newscoop s 
:. Your designer can configure 



i-line or off-line, for 






• Site Title: The default name for your publication's website. Your designer can configure your public 
to display this information 

• Site Meta Keywords: The default keyword meta tags in your header template, for search engine optimiz; 

• Site Meta Description: The default description meta tag in your header template, also for search engines 

• Time Zone: This field enables you to override the server's own time zone setting, which is typically set tc 
Greenwich Mean Time (GMT). You may wish for your Newscoop interface to display local time instead, for ir 
when scheduling publication time for a particular issue 

• Database Cache Engine: enables or disables the APC cache, which can improve Newscoop performance 

• Template Cache Handler: Select DB to enable the cache for templates 

• Imagecache lifetime: The time that images will be cached for, from 30 seconds to infinite 

• Allow password recovery: Whether users can get a password reminder by email. Note that if this feature is 
enabled and your email account is compromised, your Newscoop publication can easily be compromised in turn 

• Secret Key: The security key that Newscoop can use for integration of web services and other advanced features 

• Session Lifetime: Enables you to specify the maximum duration of Newscoop administration sessions without re- 
authentication, which is a security feature 

• Keyword separator: Specify the separator for Keywords in the Edit Article page (comma or hyphen) 

• Number of failed login attempts before showing CAPTCHA: A security measure designed to foil password- 
guessing robots 

• Maximum upload file size: The maximum size of attachments that users of your website can upload 



• SMTP Host: The server that Newscoop will use for sending out email notificatior 

• SMTP Port: The port number that Newscoop will use on the specified email serv 

EDITOR SETTINGS 

The second section of the page is for Editor Settings, which refer to image handling. 



Editor Settings 

Resizing Ratio: 



~s sizing Width: 

: ■ Miir:; Heigh 

Zoom enabled for images in 



The fields in this section enable you to specify the default resize ratio, or default width and height, for images in articles. 
If the Zoom enabled for images in article content? radio button is set to Yes, readers can enlarge article images in 
your publication's pages by clicking on them. 

EXTERNAL SUBSCRIPTION MANAGEMENT 

The third section down is related to external subscription management software. 



Reacer si.tscripucrs maracec excel rally'T l\Yes *' No 

If you select the Yes radio button for the Reader subscriptions managed externally? option, the subscription 
management features in the Newscoop administration interface are hidden. The subscription data is still held in the 
Newscoop database, which your systems administrator will have connected to your third-party subscription management 
software. 

DATABASE REPLICATION SERVER 

The fourth section enables you to set up Newscoop to operate on two servers at once, which is a safety feature in case 
of hardware or network problems. 



Setting up a Newscoop Replication Server? '& Yes O Mo 
Newscoop Online Server Database 

Database Replication Host: 
Database Replication User: 
Database Replication Password: 
Database Replication Port: 



Selecting the Yes radio button for the option Setting up a Newscoop Replication Server? displays four fields: 



• Database Replicati 

• Database Replicati 

• Database Replicati 

• Database Replicati 

3306) 



1 Host: The name or IP address of the remote database server 

i User: The user name to connect with on the remote server 

l Password: The password to submit on the remote server 

l Port: The port number to connect to on the remote server (the default port number i< 



USING AN AIRTIME MEDIA LIBRARY 

The fifth section enables you to attach media located in an Airtime storage server to articles in your Newscoop 
publication. Once you've installed and configured Airtime, create a user in the Airtime administration interface and add it 
to the Admins group. Back in the Newscoop System Preferences page, select the Yes radio button for the option Enable 
Airtime audio attachments? 



Enable Airtime audio attachments? 
AiMime Server 

Hostname/ IP Address: 

Pen 

XML RPC Path: 

XMLRPC File: 



| /airtimeJstorageServe 



Below, you should enter the host name or IP address of the Airtime server. The values of the fields Port, XML RPC Path 
and XML RPC File should already be filled in with the default values. You don't need to edit these default values, unless 
you have a custom Airtime configuration. 

The last step is to give certain users the right to attach audio files to articles. You can edit a Staff User Type to enable 
this, so that all users of this type will receive the right automatically. Alternatively, you can enable this right for individual 
staff u: 



TEMPLATES FILTER MASK 



Enter keywords for templates that you wish to hide on the Configure -> Templates page. For e 
are no longer in use, but you do not wish to delete from the server 



mple, templates that 



ited by comma) 



CRON TASKS 



Run cron tasks externally? means to use the s 
in Newscoop. 



Run scheduled tasks externally? ® Yes O No 



n scheduler for automated tasks, rather than the one included 



GEOLOCATION SETTINGS 



This section enables you to specify how maps linked to articles will be displayed, and which Internet mapping s 
provide the data. 



Geolocation Settings 

Map Center Latitude: 
Map Center Longitude: 
Map Zoom Level: 
Map Default Width: 
Map Default Height 



14.4241: 

BOO 

400 



Allow Google Streets Map Provider: 
Allow MapQuest Map Provider: 
Allow OpenStreet Map Provider: 
Default Map Provider: 



PSc'cgie Streets Map'- 



Map Marker Directory: 
Map Marker Default: 



/javascript/geocoding/ma 
I marker-gold .png wj\ 



Map Popup Minimal Width: 
Map Popup Minimal Height: 



300 
200 



VIDEO SETTINGS 



The default width and height of both externally and locally hosted video files 
the videos are displayed correctly in your publication's page templates. 









Youtube Default Width: 




H 


Youtube Default Height: 




350 


Vimeo Defat.lt Width 




400 


Vimeo Default Height: 




225 


Flash Cerat.lt v'v'ioth 




425 


Flash Default Height: 




350 


Local F las h Server: 
Local Flash Directory: 




1 




videos' 




S 



Finally, the Save button updates your preferences. 



23. 



TEMPLATES 



Templates control the look and feel of your Newscoop publication. Each publication has a unique set of templates c 
by your web developer, which should have already been installed by your system administrator. The Newscoop 
administration interface includes a template management and editing tool, which you can find by clicking Configure 
the main navigation menu, then Templates. 





System Preferences 

Article Types 
Topics 
Languages 
Countries 








Dashboard 






Add more widgets 






Most Popular Articles 


h C 






Showing 1 to 53 of 53 entries 









Templates are organized into folders, shown in a box on the left hand side of the page. 




Conflgure > Templates > Patti:/ > 










Templates 






=&= Create new folder =8= Create new template □ Upload template 






| Actions... J Select All | | Select None | 
















Folders Delete 




Files Template ID Cache lifeline. ;e 


c DU| 


| — l □ 

n k □ 

1 — 1 f eec | " 
B sy ste m_te m p 1 ate s "■ 


□ J get-rss.php 996 

















e of a folder shows the files included in that template. 



Configure > Templates 


> Mhtl cbssfci > 






Templates 










3 Go Lip 4" Create new folder ■£■ Create ne 


w template 


D Upload template 




1 Actions... 


_^J | Select All Select None 














Folders Delete 




Files 


enplate ID 


"etime. sec Duplicate 


D css u 

Ding B 

m E3 


□ J archive.tpl 


167 


■ 


□ Ja.cle.tp, 


173 


■ 


n n " 

U J index.tpl 


172 


o 


□ _] register.tpl 


168 


■ 






LJ _] search -re su It. tpl 


169 


■ 




D _] section.tpl 


171 


o 


□ _] topic.tpl 


170 


% 















In turn, clicking 
changes to tempi; 




This feature enables web developers to make quick 



Configure > Templates > Path: I classic* > 



Edit template: article.tpl (Template ID: 173) 



it template: Iclassic/article.tpl 





ft <c) |Mpt d |Smarty ^ J & |Q| 


1 

: 
:-. 

4 
5 
6 
7 
3 
9 
IB 
11 
12 


|{ include file="cla55ic/tpl/header.tpl" H 


<body id="article" class="section-{{ $gimme->section->number }}' 
<div id="container"> 
<div id='wrapbg"> 
<div id="wrapper"> 


{{ include file="classic/tpl/headernav.tpl" }} 


<div class-'colmask rightmenu"> 
<div class="colleft"> 
<div class="collwrap"> 
<div class="coll"> 



You should only make changes to the templates if you know what you are doing, because any modifications will 
immediate impact on the appearance of your publication. This feature is also useful for editing templates on a 
development server before they are copied to the publication's production server. 



24. 



ARTICLE TYPES 



Article Types specify the information that Newscoop will require from the journalists adding a particular kind of article ti 
your publication. For example, a feature story is likely to require more elements than a brief news item. By default, 
Newscoop has one Article Type set up, which is News Article, but you can create as many as you need. To create or 
manage your Article Types, select Configure, then Article Types from the main navigation menu. 





3;.-: i.8i" Preferences 

Languages 
Countries 








Dashboard 






Add more widgets 






Most Popular Articles 


X f 






Snowing 1 to 53 of 53 entries 









This action opens the Article Types page. Article Types consist of a sequence of fields, with each field holding a certain 
kind of data. Currently, there are six kinds of fields available: 

• Single-line text: this type of field can contain a maximum of 265 characters, and does not support HTML tags. Its 
appearance and character set is entirely determined by the template in use 

• Multi-line text with WYSIWYG: this type of field can be up to 16MB in size. The journalist can insert images, audio, 
video, links (external, internal or to attached files), and formatting tags. Subheads can be used for article pagination 

• Date: this is a standard date field with a fixed syntax of YYYY-MM-DD (four year digits, two month digits, two day 
digits, separated by hyphens) 

• Topic: this type of field can be used to categorize articles. Each topic field has a top level element, for example 
Entertainment / Review. When the journalist types the article into Newscoop, this field will display a drop-down 
menu containing available subtopics of that top element, such as Movie Review or Theater Review 

• Switch: allows you to add check boxes which activate particular features to the Edit Article page. For example, you 
might add a switch breaking_news, which would be used by your template to display the article in a special place on 
your site. (Newscoop comes with two switches by default, Show article on front page and Show article on section 



< Numeric: allows you to add 






;, such as longitude/latitude, temperature, c 



Newscoop makes a distinction between the Template Nai 
Template Name is limited to letters, numbers, and undi 
template. The Display Name is the part that the journalist 



id Display Name 

(no spaces) and i: 
;e, and can be tr, 



for each Article Type and field. The 
used internally by your Newscoop 
nslated into other languages. 



ADDING A NEW ARTICLE TYPE 



cle type link at the top left of the Article Types page. 







Configure > 


Article Types 




4" Add new article type ^ Merge types 


S^ Shaw display names 




Template Type Name Fields Display Name 


Translate Show/Hide Comments enabled? 


news_article Fields News Article [en] 


IP • • 









The Add new article type page will appear. The first step is to enter the Template Type Name of the Article Type you 
wish to create. In this example, we'll create an Article Type with the template type name review_article - note that it has 
an underscore, instead of a space, between the words review and article. 



Configure > Article Types > 

Add new article type 



Add new article type 

The template name may only c< 
Template Type Name: 



■•: arc ire underscore (_} character. 



_HL 



After you click the Save button, you will be prompted to enter the Template Field Name of the first field in the new 
Article Type. Select one of the six field Types available from the drop-down menu, for example Topic. For this particular 
field type, we'll also have to select a top level element, such as Entertainment / Review. 



Configure > Ar 



r;_article > Article type fields ; 



Add new field 












Trie template name may only contain lett 


ers and the underscore (_) character. 




Template Field Name: reviewjopic 


1 










Type: Topic 


dl 




i I ' ■ ■ ■ z - z \ 


d 


^ 











After clicking the Save button, the Article type fields page is shown. The Article Type that you a 
is shown in the breadcrumb trail beneath the n 



currently working o 




Configure > f 


rticte Types > ,eviev. La ,ticle > 




Article type fields 




^ Back to Article Types List 

+ Add new fie Id €^ Show display jiames 






Order 


Template Field Name Type Display Name Translate 


Is Content Shoi 




reviewjopic Topic (Review) reviewjopic |l*J 


WA 











Click on the Show display names link to add a Display Name for this new field. Select the language you require from 
the Add translation drop-down menu, and enter the display name for the new field in this language. Then click the blue 
Translate button. 



Configure > Article Types > review_article > 




Article type fields 




•^ Backto Article Types List 

* Add new field G^ Hide display names 






Order Template Field Name Type Display Name Translate 


Is Content Shot 


review topic Topic (Review) review_topic p 


N/A 








Add translation: English ^\\ Review Topic) 













The Article type fields page will now show the Display Name for the field, together with a language code (in brackets) 
to indicate its translation. Note that the Display Name can contain spaces, or be capitalized differently from the 
Template Field Name. 



Cprcfaiire > Article Types > review_article > 




Article type fields 




^ Backto Article Types List 

+ Add new field G^ Show display names 






Order Template Field Name Type Display Name Translate 


Is Content £ 


reviewjopic Topic (Review) Review To pic (en) pj 


N/A 









Continue to z 
Types List, r 



new fields to this Article Type, until you have 
t to the blue arrowhead icon. This action will re 



hat you need. Then click the link Back to Article 
n you to the Article Types page. 



EDITING ARTICLE TYPES 



You can add translated Display Names for your n 
Article Types List. 



v Article Type after clicking on the Show display n 





Centre > 


Article Types 




4 1 Add new article type ^f Merge types 


G^ Hide display names 




Template Type Name Fields Display Name 


Translate Show/Hide Comments enabled? 


news_article Fields News Article (en; 


P 


* » 




en News Article 


es articulo 




Add translation: |f38*S: jj| 




Translate 




review_article Fields review_article 


m 


• • 




Add translation: | English _^| 


Review Article| 


J ■ ■mranji 













Article Types are not set in stone; they can evolve as your publication evolves. For example, you can hide old Article 
Types that are no longer in use. Toggle whether a type is shown by clicking on the colored light icon in the Show/Hide 
column - green for shown, red for hidden. A pop-up dialog will ask you if you are sure about this action. 




Hiding a type is less dangerous than deleting it; the latter action will remove the associated content from the server 
delete button is a white cross in a red square icon, over on the right side of the page. Use this button with caution! 



Fields Display Name 


Translate 


Show/Hide 


Comments enabled? 


Delete 


Fields News Article (en) 


IP 


• 


• 


□ 


Fields review_article 


P 


• 


• 


I 



As usual when carrying out an action that will have an impact on your publication, Newscoop will ask you if you a 



*?* *- Wr - : - '-• -^ ML 



Are you sure you want to delete the article type review article? 
WARNING; Deleting this article type will delete all the articles 
associated with this article type. 



| ©Cancel | ^9 OK 



In the Article Types List there is also a Comments enabled? column, which toggles readers comments on and off for a 
specific Article Type. For example, you might wish to disable reader comments for all entertainment reviews, but leave 



them enabled for news articles. 

Article types can be renamed, simply by clicking on the Template Type Name in the Article Types page. Remember that 
if you change a Template Type Name, you cannot put spaces into it. 



Configure > Article Types ; 



Rename article type Teview_article' 



Trie template name may only contair letters arc tie underscore (_} 
Template Type Name: review5|_article 



-^L 



EDITING ARTICLE TYPE FIELDS 

On the Article Type Fields page, fields can be renamed, given Display Names, hidden or deleted, just like Article Types. 
When you have more than one Article Type field, you can re-arrange the order in which the fields show up on the Edit 
article page by clicking the blue up and down arrows. 



Configure > Article Types > review_ar 


tJcte > 








Article type fields 












^ Bach to Article Types List 
+ Add new fie Id (^ Show 


display names 










Order Template Field Nan 


ne Type 


Display Name 


Translate 


is com 


♦ reviewjopic 


Topic (Review) 


Review Topic [en] 


|PJ 


N1A 


# 4 show.name 


Single-line Tea 


Name of Show [en] 


P 


H/A 


4k star_rating 


Numeric 


,i out of five [en) 


P 


NIA 















To change a field type, for example, from Single-line Text to Multi-line Text with WYSIWYG, click on the 
corresponding link for that row in the Type column. The Reassign a field type page will open, on which you ca 
the new type from a drop-down menu. Then click the Save button to return to the Article type fields page. 



E 



■ 



Configure > Article Types > review_article > Article 


type fields > 


Reassign afield type 














Type: Multi-line Text with W-'SIW-'G ~ 


I 









After editing article type fields, you could ci 
78 



t that the updated fields are displayed as expected. 



Cortert > Publication: l|-eCi:.lc 



;: issLel (English Section: Lifestyle : 



Movie Night 



Created: 2011-01-21 17:49:40 Q Last matUBed : 2011-01-21 17:49:40 
Review Topic 

Entertainment; 1 Review/ Movie Review 

Name of Show 

i i u « | m m m m | iMF«l^iX[&a^|-> ' I n | m ~ d. 

" L ■ — A • ^ - X, x" I A *& I != 1= I S^^ - P""™ 1 T Fontfamiy 

enry Plotter and the Suitcase of Cash 



Star rating out of five 



MERGING ARTICLE TYPES 

Newscoop enables you to merge two different Article Types so that content in fields from one type (the Source ; 
Type) is migrated to another (the Destination Article Type). This is a useful process to go through after adding o 
editing an Article Type, so that all previously written copy matches the new Article Type fields. 

On the Article Types page, click the Merge types link. This opens the Merge article type page. Select the source 
destination Article Types you wish to merge from the drop-down menus. 



Merge article type 










Merge Article Types: Step 1 of 3 

Source Article Type Destination Article Type 




ievitv:_anicle;^j news_arb"cle _rj 









Next, choose the fields of the s 



e which you'd like to merge into fields of the destination. 



Configure > Article Types ; 



Merge article type 










Merge Article Types: Step 2 of 3 

There are 1 articles associated with Review Article that will be merged. 

Source Article Tvpe Destination Article Tvpe 
Review Article -> News Article 




JF.r r.'. ~:j|j ; | t -> [j ec |< 


1 Name of Show jl -> Lead and SMS 


1 Star rating out of five tJ| _> Body 


| Back to Step 1 











The next screen displays the result of the potential merge. Any source fields which have not been mapped to destination 
fields are shown in a red font. You may need to create additional fields in the destination Article Type before attempting 
the merge again. 

You can cycle through all the articles which will be merged, and preview the changes. Optionally, check the box to Delete 
the source article type. When you're ready, click the Merge button. 



Merge article type 



Merge Article Types: Step 3 of 3 

Merge configuration for merging Review Article into News Article. 

Merge review Jopic into Deck 

Merge show name into LearJ_anrJ_SMS 

Merge star rating into body 

(!) Do NOT merge conclusion (No merge warning.) 

Preview a sample of the merge configuration. Cycle through your articles to verify that the merge configu 
[Review Article) version of Movie Night) 1 of 1. 



Name: Movie Night Created by: 


Daniel James 


Show article on 1 


Type: Mews Article Creation date: 


201H)1-21 17:49:40 


Show article on 


Number: M 


Publish date: 


0000-00-00 00:00:00 


Allow users with 


Keywords 


teen, wizard, franchise 






Deck 
Lead and SMS 

Body 


41 






Henry Plotter and the Suitcase of Cash 




| U 













icle type (Review Article) when finished. 

| BacktoStep2 



If there are no articles left belonging to the Source Article Type, Newscoop will display a warning message at the first step 
of the proposed merge. 



Configure > Article Types > 

Merge article type 



Merge Article Types: Step 1 of 3 



The source article type (review_article5 does not have any articles. 



S 



25. 



TOPICS 



In Newscoop, topics are the subject matters assigned by editors and journalists to articles, so that related articles ca 
identified and displayed together. A topic can have many subtopics; for example: the sports topic could have the 
subtopics football, basketball, and water polo. An individual article may have several topics or subtopics assigned to it 



e topics, click Configure on the main navigatio 



i, then click Topics from the sub-n 













Dashboard 






Add more widgets 






Most Popular Articles 


a C 






Showing 1 to 52 of 52 entries Htti^^l 





To add a new top-level topic, select a language from the drop-down n 
Then click the Add button. 



3rd in the Add root topic field. 



Show languages 

Select All Select None 

en D de D pt D ft es D ro □ hr D cz □ sh D sr D ru D sv D zh D ar D 



English - Travelj 



:H | 



To rename a topic, click the Edit link to the right of the topic or subtopic nami 
Change topic name field. Update the name, and then click the Save button. 



v will expand to show the 



/ Edit K 
S Edit X 



Freaky Weather] 



English Q 



:ra 



Add translation: 



I —Select language— tI| 



II: es Lunatic o Tie m pro 



You can translate topic names so that they appear in the correct language when an author is editing an article. To 
translate a topic, click the Edit link to display the Add Translation field for that topic name. Select the language you are 
translating into from the drop-down menu, enter the translation of the topic name, and then click the Translate button. 















I en Travel 




/ Edit X 




1 Q en Weather 




/ Edit X 
















Weather 


|| SHI | 


1 




Addsubtop,, 
















English | 


II -1 










trans anon. 








Deutsch 


_rj| Wetter| 


1 












iii gesTiempo 




f Edit x 











If you translate a subtopic and its parent has not yet been translated, the parent topic will appear in its original language 
until you translate it. 

To add a subtopic, click the Edit link next to the topic you want to put the subtopic under. Enter a word or two into the 
Add Subtopic field, then click the Add button. 



Englisn|~Local| 



Add translation: 



3C 



~| | Translate ] 



|| [TjesTiempo 
The new subtopic will appear underneath its parent topic. 



ik en Travel 


S Edit 


X 




||; Q en Weather 


f Edit 


X 


|| QesTiempo 


•' Edit 


X 



You can delete a specific topic or subtopic using the blue 
delete a topic currently in use by an article, Newscoop vs 



III en Local 


/ Edit X 




|| g en Storms 


/• Edit X 


1 [JJ es Tormentas 


S Edit X 




1 en Freaky Weather 


f Edit X 


I es Lunatic o Tie mpo 


/ Edit X 



on the right hand side of it 
about this. 



Configjre > Topk:s > 

Deleting topic 



There are 2 articles using the topic. 



26. 



LANGUAGES 



While Newscoop's default language 
Configure on the main navigation i 
the system. 



; English, you are by no means limited to publishing in that language only. Click 
lenu, then Languages from the submenu, to see the languages currently available o 















Dashboard 








Add more widgets 






Most Popular Articles 


:: C 






Stowing 1 to 53 of 53 entries 





The Language page enables you ti 
:r ISO 639-1 code nar 



configure support for languages that you wish to publish in. The Code column refers t< 
; for each language. English, for example, is en, German is de, Spanish is es, Russian is 




Languages 



+ Add new language 

Language Native m 



Code Delete 



I 


English 


German 


Deutsch 




Portugues 


French 


Francais 


Spanish 


Espafiol 


Romanian 


Romana 


: 


Hrvatski 


Czech 


Cesky 


Serbo-Croatian 
Serbian (Cyrillic) 


Srpskohrvatski 
CpncKH [Tin | 


Russian 


PyccKHii 


Swedish 


Svenska 



Click on a name in the Language column to open a page for that language, which e 
time name translations. This feature ensures that automatically generated publicat 
particular language are displayed correctly to your international readers. 



ibles you to adjust month, day and 
n dates and times for an article in a 



Name: Georgian| 



Code: GE 



January: 


u63A«d 






February: 


| mrjorjfesfiepn 






March: 


Biftftn 






April: 


aSftncpn 






May: 


34rtbn 



To add another language, click on the Add new language link, r 
language name (both in your own language, and the Native nan- 
cy for Welsh). 



: to the green cross icon. You should enter the 

n the language itself), and its two-letter ISO code (e., 



Configure > Languages ; 



Add new language 










Add new language 






Name: Welsh 




Native name: Cymraeg 




Code: cy 


Please enter the translation for month names. 


January: lonawr 




February: | Chwefror 




March: Mawrth 




April: Ebrill 




May: Mai| 





After entering translations in all the fields, click the Save button at the end of the page. The 
shown on the Languages page. 





Georgian jiftrogcjo 


GE 


□ 




Chinese (Traditional) SflS^S 


zh_TW 


U 


Polish Polski 


Pi 


□ 


Welsh Gymraeg 


cy 


□ 













You may wish to limit the number of languages configured on your server, in order to spare your editors and journalist 
from having to navigate long drop-down language menus. To remove a language, click the white cross in a red square 
at the end of each row in the list. You will be asked if you are sure about this action. 



m tti* p*:-* X :^c:r- ^t:::^::.v.; ?; ^:^ifert.;. 



Are you sure you want to delete the language EejiapycKan? 



C9ok 



27. 



COUNTRIES 



This page determines how country lists will appear in forms that readers fill ir 
newsletter. It also enables you to create country lists in different languages. 1 
default language, click Configure on the main navigation menu, then Countrit 



• example when signing up for a 
:e the list of country names in 1 
n the submenu. 











Dashboard 






Add more widgets 






Most Popular Articles ■^■^^H 


h C 






Showing 1 to 53 of 53 entries ■H^^l 





The Countries page shows an alphabetical list of countries, with the language they are displayed in, and a two-letter ISO 
3166-1 country code for each name. Note that the alphabetical sorting is by the country code, rather than by the country 



Configure > 

Countries 



4 1 Add new country 

Language: 



_j| | Search | 



1|2|3|4|5|6|7|8|9|10|N 



Language Code Translate Delete 



Andorra 


English 


United Arab Emirates 


English 


Afghanistan 


English 


Antigua and Barbuda 


English 


Anguilla 


English 


Albania 


English 


Armenia 


English 


Netherlands Antilles 


English 


Angola 


English 


Antarctica English 


on the name of a country to e 



AG Translate U 
□ 
U 

u 
u 
□ 



edit it, then click the Save button to return to the country list. 



Configure > Countries > 



Edit country name 



Edit country name 

Country: Netherlands Antilles 
Name: | Dutch Antilles] 



-HL 



To translate a specific country name into a particular language, click the Translate link in that country's 
the Translate country name page, select the target language from the drop-down menu, and enter the 
the Name field. Then click the Save button. 




Configure > Countries > 

Translate country name 



Translate country name 
Country: Germajiy 



Name: De 



BB 



To find your translated country n; 
the language you are interested ir 
Search box. 



mes later, use the drop-down Language r 
and then click the Search button. The se 



enu at the top of the Country page to select 
irch results, if any, will be listed below the 



Configure > 

Countries 



+ Add new country 








Language: Deutsch 


-=111 


Search 












Name [click to edit) Language 


Code 


Translate 


Delete 


Deutscriland Deutsch 


DE 


Translate 


□ 



Newscoop's list includes almost all known countries by default, but if you have deleted a country and need to put it back, 
you can do this by clicking on the Add new country link next to the green cross icon. You will be prompted to enter the 
country's two-letter ISO code, name and language. The drop-down menu will contain as many languages as you have 
defined in Newscoop's Configure - Languages page. 



Configure > Countries > 



Add new country 










Add new country 




Code: [ac] 

Name: Ascension lsland| 




Language: English _^J| 









Note that the language you are asked to specify is the language in which yoi 
language spoken in the country. 



28. 



THE LOCALIZER 



The default language for the Nev 
translations supplied with Newsc 
Localizer to improve an existing 



jop administration interface is English, but you can either use one of the many 

, or create your own translation using the built-in Localizer tool. You can also use the 

islation, or adapt it for a regional dialect. 



The first step is to check that the language you wish to translate into is in the Configure Languages list. If your target 
language does not exist yet, you will have to add it to Newscoop first. Then, you can open the Localizer by clicking 
Configure, then Localizer on the main navigation menu. 











Dashboard 






Add more widgets 






Most Popular Articles 


:: C 






Shaving 1 to 53 of 53 entries iHii^H 





The Localizer works by enabling you to translate individual 'strings' of text that appear in the Newscoop administration 
interface. There are 2091 strings in the whole of Newscoop, divided into 40 Screens representing the various different 
pages in the interface. You can complete a localization with a team of translators working together, by tackling one 
screen each at a time. 



Translate from: 



_-j| I English 



2J Espafiol 



strings j| | Submit | 



a lz zj 






en: Plugins 


Irj Plugins 


en: Manage Plugins 


lr-J Administrar plugins 


en: Account 


Irj Cuenta 


en: Items per page 


b-i Items por pagina 



Select your source (Translate from) and target (Translate to) languages from the drop-down menus, and then select a 
Screen, such as Geo-location or Article Types. Strings that have not yet been translated are shown in a red font. You ce 
save your work at any time by clicking the disk icon next to one of the input fields. When you have completed your 
translation, there is a Save button at the end of the page. 

You will encounter strings with a dollar sign in them, e.g. "$1". This means that one or more words will be substituted in 
place of these characters. For example, the phrase "Signed in: $1", when displayed on the interface, might be: "Signed in: 
Administrator". In this example, "Administrator" was substituted for "$1". 

en: There are $1 article.;:.: lei 



trj | Hay$l articulo(s] pendiente(s) 



Irj Quedan $1 suscripciones. 



en: There are $1 section(s) left. 
k-i | Hay $1 5eccion(e5] pendiente(s] 



en: There are $1 publication^} left. 
tr-J Hayitl publicacion(es] pendie 



en: There are $1 



IjJ | HaySl pais(es) pendiente(s) 



TinyMCE, the WYSIWYG article editor incorporated into Newscoop, can also be localized. The strings in TinyMCE have to be 
edited manually by your system administrator, which is a task done separately from the Localizer. 

SENDING A LOCALIZATION BACK TO THE NEWSCOOP TEAM 

We actively encourage Newscoop users to send us their language localizations. This makes Newscoop more useful for 
people around the world. Even if a similar language localization exists, it may not address your particular needs or regional 
differences. For example, there may be differences in Spanish between that used in Spain and that used in Guatemala. In 
that case, you can localize Newscoop to your needs and share the localization with other users that speak your language 

For more information on how to contribute a localization to Newscoop, please email contact0sourcefabric.org 



29. 



LOGS 



The Newscoop administration interface includes a feature which enables you to keep track of who has done what, and 
when, on your publication's server. You can examine Newscoop's log files by clicking Configure on the main navigation 
menu, then Logs. 











Dashboard 






Add more widgets 






Most Popular Articles 


:: C 






[\ 









The default log view displays all recent events on the Newscoop s< 
events first. Click the Next link or page number just above the se. 
features in Newscoop, the Logs page is multilingual, so you may se 



r, with 15 listings per page, and the most 
results box to see previous pages. Like 
g entries in languages other than your o\ 



Configure > 








Logs 














Event | 




j| Search | 






l[Z[3|4[S[6[7|B|a 


10 | Next | Next 10 | Last 






Date/Time 


User 


Event 


Description 


2011-01-28 13:04:53 
2011-01-28 12:3403 
2011-01-28 12:11:00 
2011-01-28 12:1041 
2011-01-28 12:07:56 
2011-01-28 12:06:40 




Add language 


Language "Welsh" (Cymraeg) added 


Add country 


Country Ascension Island (AC)addei 


Change country nan 


e Country name Deutschland (DE) cha 


Change country nan 


e Country name Deutschlant (DE) char 


Add country 


Country Deutschland (DE) added 


Change country nan 


e Country name Dutch Antilles (AN) chi 



e the logs selectively, use the Event drop-down menu above the search results box to select a particular 
action; for example, Add country. Then click the Search button, and the Logs page will be refreshed to list events 
corresponding to that action exclusively. 



Configure > 








Logs 














Event 1 Add country 


^MB| 








Date/Time User 


Description 




User IP Address 




2011-01-28 12:3403 
2011-01-28 12:07:56 


Country Ascension Island (AC) added 




Country Deutschland 


(DE) added 
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USER MANAGEMENT 



Newscoop's user management features enable you to control access for both Staff users and Subscribers. You can 
define User types for your staff members, such as Journalist or Editor, and manage author profiles. User management 
tasks have their own sub-menu on the main Newscoop navigatio 




Initially, Newscoop has only one user account: admin. Do not delete this account, as it is needed by the feature which 
informs staff users of events on the Newscoop system. The email address associated with the admin account is used a; 
the "Reply-To" address in these notification emails. 



s right for every single user, Newscoop enables you t> 



CREATING USER TYPES 



A User type is defined by a checklist of tasks that the 
tasks ranges from creating, managing and editing publi 



Instead of configuring each ; 

can be assigned to multiple users. 

Newscoop has five default user types, in order from most to le; 

• Administrator - full authorization 

• Chief Editor - has the right to create and delete issues 

• Editor - limited to basic article management and editing 

• Journalist - can create articles, but not delete them 

• Subscription manager - can't change editorial content 



o perform ir 



the Newscoop system. This list of 
3 template and plugin management. 



r type, select Staff User Types from the Users n 



i, then click the Add n 



to the green plus sign ic 



User types 




+ Add new user type 






Type Access Delete 




Administrator Change Li 
Chief Editor Change Li 
Editor Change □ 
Journalist Change Li 
Subscription manager Change Li 









Name the new user type, and check the boxes for the rights that yoi 
button at the top or bottom of the list. 



labled for this type. Then click the Save 



^M 



^^^^^^B 



Users > User types > 



Add new user type 



Add new user type 




| Save 




Name: Sub editor 








| Select All Select None 




-Content- 




□ User may add/change publications 




□ User may delete publications 




D User may add/change issues 




□ User may delete issues 




□ User may addfcnange sections 




□ User may delete sections 




User may add articles 




User may change articles 




User may move articles 




User may translate articles 




IM User may attach images to articles 





o the User types list, your new user type should be shown there. 



User types 




■ft" Add new user type 






Type Access Delete 




Administrator Change U 




Chief Editor Change 13 






Editor Change El 






Journalist Change El 






Subscription manager Change El 






Subeditor Change El 











CREATING STAFF USERS 



To add a new Staff u 

the green plus sign ice 



-, select Staff from the Use 



and then click on the Add new staff member link n 



Staff management 




■8" Add new staff member 








Full Name P 






Account Name 


E-Mail 






Full Name {}? Account Name 


E-Mail 


User Type I 






Administrator admin 


suppon@sourcefabric.org 


Administrator N, 


"• * • • 


• "^^""^ 


2( 
Administrator 2( 



You should specify the account name, password, full n 
choose a User type (either one of the default types, o 



e-mail address and phone number of the n 
type that you have created). 




Add new staff member 


















Account name: suziqsub 


■;- 


1 

Clean 


Password Generator: | Generate | 






nml 


















Full Name: | Suzi Q. Subeditor 




E-Mail: | sub@example.com 








Prone: 1 555 123 456 


1 






Type: Subeditor 


4 







Click the Show m 
end of the page. 



s link to add further information about this new user. Then click the Save button at the 



fi Hide user details 

Title: 
Gender: 

City: 

Street Address: 

Postal Code: 

State: 

Country: 

Fax: 

Contact Person: 

Second Phone: 

Employer Type: 
Position: 


OMale ® Female 






25-39 J 




Example City 








123 Example Street 








123 ABC | 




Example State 








Ascension Island 




dl 








555 123 457 




Mom 








555 321654| 




The Journal 


1 






Media 


zll 






Sub Editor, Real Estate 


1 


| Save | 





If you would like to fine-tune the rights assigned to this new user, follow the Click here t 
link on the subsequent page. 



Change user account information 




+ Add new staff member 






Account name: suziqsub 




Full Mame: | Suzi Q. Subeditor 




E-Mail: sub@example.com 




Phone: | 555 123 456 


{+) Click here to change password 
ff) Show more user details 


User Type: Subeditor _^| 

ff) Click here to customize user permissions 

1 ^ 1 









MANAGING AUTHORS 

Newscoop includes a feature for managing author profiles, which you can find by clicking Manage Authors on the Users 
menu. Authors do not necessarily have corresponding login accounts on the Newscoop system, but they can still be 
credited as contributors to articles. 



Manage Authors 











Author 


Type 


Delete 


Amerigo Vespucci 


Author 


□ 


Daniel James 


Author 


□ 


Douglas Arellanes 


Author 


□ 


Global Wire Service 


Author 


□ 


James Q. Reporter 


Autitor 


□ 


: i.v/riter 


Author 


□ 


Jeffrey McManus 


Author 


□ 


Orlando Persona 


Author 


□ 


Sarah Staffwriter 


Author 


□ 


Sava Tatic 


Author 


□ 


Strewing 1 to 10 of 11 entries 

HE 



First name: 


c 


Last name: 


r 


Aliases: 


r 


Type: 


All til 
Writs 
Pliol 

E::- 
Call. 




Contacts 




Skype: 


\z 


Jabber: 


r 


AIM: 


r 


- 


r 




Re 



Further information can be saved for each author, using the three tabs on the right-hand side of the page. Multiple author 
types can be assigned for credits on a particular article, including Writer, Photographer, Editor or Columnist. The Biography 
tab includes a field for uploading an author photo, while the third tab, Content, tracks any articles associated with the 
author. 



I Biography 







First name: 


Sarah 






Last name: 


Staflwriter 






Aliases: 


^H 


Type: 






Writer 
Photographer 








Contacts 




Skype: 


sarah.staffwriterlSEO 






Jabber: 


1 






AIM: 


1 






Email: 


sarah@example.com 




Reset 




m 
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SUBSCRIPTIONS 



Newscoop allows you to control reader access to your publication through its built-in subscription feature. (If you want to 
have all your content freely accessible, your designer can bypass the subscription feature in your publication's templates). 
Articles that you create in your publication are available to subscribers only by default. Administrators have the right to 
make a particular article accessible to non-subscribers. 

A non-subscriber who tries to access a subscriber-only article is provided with the option to subscribe immediately to 
that article, all articles in the same section, or the whole publication. A trial subscription is activated immediately, with 
the duration of the trial determined by the Default time period setting. (You can change this setting for your publication 
by clicking the Configure icon in the Publication list). During this trial period, the reader has a chance to make payment, 
and consequently have their subscription extended by an administrator. 

The publication's administrator is automatically notified of all new subscriptions by e-mail. Subscribers also receive 
automatically generated e-mail reminders that their subscription is expiring two weeks before the event. The text of the 
subscription expiry message is created in a Newscoop template by your designer. The default system template reads as 
follows: 



Newscoop enables you to control access to your site in two ways: 

• Username/password pairs, which are suitable for individual users 

• IP address range access, more suitable for institutional subscribers (libraries, universities, NGOs, companies) 

USERNAME/PASSWORD ACCESS 

Newscoop enables readers to subscribe to one publication at a time. Within a publication, the level of subscription is the 
section. The reader is able to select any section from the publication, and for each section specify the period of time they 
would like to have a subscription for. Before submitting their request, the reader can evaluate the cost of the 
subscription and change it. At any time later, they can subscribe to additional sections. Once the user has subscribed to a 
section, they can't increase the period of time for the subscription until payment is made for that section. 

Immediately after the completion of the subscription form, the reader has the right to view the site. By default, the 
reader has seven days to make a payment and have his subscription confirmed by the administrator, or else the account 
is locked. 

The authorized person can confirm the payment, so that the subscription remains active after the first seven days. 
There are two options in the administration module for that: change the value of the amount that the subscriber has to 
pay, or change the number of days the subscriber is allowed to view the publication's site. By default, if this value is set 
to zero, the number of paid days is automatically set to the number of requested days. 

The administrator has seven days to confirm the payment. The confirmation is made from the main menu, by selecting 
User and then Subscriptions. The confirmation consists in changing the payment status (from 'no' to 'yes'). 

IP ADDRESS SUBSCRIPTIONS 

The IP based access can be used to automatically log in users that have known IP addresses that never change. Examples 
of this are libraries, colleges, or schools. The IP address-based access works by recognizing a computer as owned by a 
certain subscriber based on the computer's IP address. Subscribers with IP address-based access will be allowed to 
s the site without being prompted for user names and passwords. 

n IP Address subscription, go to the Subscribers page. First create a regular user by clicking on "Add new user 
Jit it by clicking on the "Full Name" link in the subscriber list and click on "Add new" link in "User IP access list 
management" table. The form allows the input of a group of consecutive IP addresses. If necessary, more groups can be 
added. The start IP address is the smallest address in the group, while the number of addresses sets the size of the 
group. 

For example, if a university library had a group of IP addresses: 120.120.120.0 to 120.120.120.63 then you would enter: 



• start IP address: 120.120.120.0 

• number of addresses: 64 

It is not necessary to add anything to the templates, or to inform the users who will be accessing the site through IP 
address authentication of the existence of this User Name/Password pair. 

It is also possible to search for users based their IP addresses. In the subscribers list fill in at least one box in the field 
named "IP address" from left to right. The administration screen will display all readers that have IP addresses matching 
the input. For example, if we had two clients, one with IP access group: 120.120.120.0:64 (start IP address 120.120.120.0, 
64 addresses), the other one with IP access group: 120.120.140.0:64 then we will have the following results: 

• filling in 120.120 in the IP address field will return both clients 

• filling in 120.120.120 will return only the first client: the second client's IP access group 120.120.140 doesn't match our 

• filling in 120.120.120.10 will return the first client 

• filling in 120.120.120.80 will return an empty list: the IP access group of the first client stops at 120.120.120.63 

CUSTOMIZING THE SUBSCRIPTION FORM 

The subscription interface for the user is customizable. Depending on the user's status, several steps must be taken by a 
user in order to be able to read the publication. There are three possible scenarios: 

• The user has never subscribed. In this case, the user is served a subscription form (name, login, password, email 
etc). After the completion of this form, the user can start subscribing to any section 

• The user has already subscribed (i.e. is a known user to the system) but only to a few sections. In this case, he or 
she wants to add more sections to the subscriptions they have already made - some of which might have expired. 
The user should be served a different subscription form (reflecting his status as a known user). 

• The user is not known to the system even though his subscriptions are active (e.g. the subscriber hasn't logged for 
a long time). A login form must be supplied for such a user. 

The template designer can customize all those forms by means of Newscoop's template language. 

SYNCHRONIZE NEWSCOOP AND PHORUM USERS 



This feature is found on the Users menu. It enables administrators to update the database of reader loj 
that readers can post comments in both the Newscoop publication and an associated Phorum bulletin board. 
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USING PLUGINS 



Plugins enable your system administrator to add functionality to your Newscoop installation without having to write a 
large amount of code. They can also enable you to make better use of the content and templates already in your 
Newscoop publication. Currently, there are three plugins installed by default with Newscoop: 

• Polls: A mechanism for site visitors to vote on a question; the question can be set dynamically and can be 
multilingual 

• Interviews: Enables on-line interviews for your Newscoop publication; users have to refresh the page regularly to 
get the latest questions and answers 

• Blogs: Enables users to create and post to their own blogs, including comments 

INSTALLING NEW PLUGINS 

Once plugins are downloaded to a local hard disk, they can be uploaded to your Newscoop instance. Log in to your admin 
interface and go to Plugins -> Manage Plugins. From there you can select the plugin to be uploaded. Plugins must be 
uploaded to the Newscoop instance as a .tar archive. 

Selecting 'Manage Plugins' pulldown menu also provides you with a list of installed plugins; there is a check box to disable 
the plugin and a red X to delete the plugin from your system. Once a plugin is correctly installed, you will be able to 
administer it separately from the Plugins pulldown menu. 

Plugins require changes to your site's templates, but each plugin also includes sample templates to either copy and paste 
or to use as a guide to your own templating. 



HELP 
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33. 



WHERE TO GO FOR SUPPORT 



Sourcefabric offers full commercial support for Newscoop. Additional support is provided to the Newscoop user and 
developer community. 

Forum and mailing list: You can visit the Newscoop online support forum, and sign up for the mailing list, at 
http://forum.sourcefabric.0rg/index.php/f/IO/ . 

This forum is mirrored by the mailing list, so posts on the forum appear on the mailing list and vice versa. You can 
therefore also post a message there by emailing: newscoop-support0lists.sourcefabric.org . 

To subscribe to forum updates via mail, please register or login to the forum by clicking the appropriate link. Then click 
the 'Subscribe' button at the top of each forum page. 

Bug reporting: Newscoop needs your input to improve. If you think you've found a bug, please visit 
http://dev.sourcefabric.org and sign in, using the same login and password that you registered for the Newscoop forum. 
Create a bug report by selecting Create Issue, then Newscoop, and then Bug. That way, the Newscoop team can keep 
track of your problem and notify you when it has been fixed. You can also suggest improvements and new features for 
Newscoop on that site. 

Contact: Finally, when all other avenues have been exhausted, email us directly at contact0sourcefabric.org and we'll try 
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CREDITS 



Newscoop is being developed by an international community of developers and designers led by Sourcefabric. 

http://newscoop.sourcefabric.org 

Copyright © 2011 Sourcefabric o.p.s. 

Copyright © 1999-2010 Media Development Loan Fund. 

LICENSE 

All chapters in this manual are licensed with the GNU General Public License version 3. 

This documentation is free documentation; you can redistribute it and/or modify it under the terms of the GNU General 
Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later 

This documentation is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the 
implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for 

You should have received a copy of the GNU General Public License along with this documentation; if not, write to the 
Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. 

AUTHORS 

This manual has been edited and reworked by Daniel James, based on the collaborative effort at FLOSS Manuals. Thanks 
to all contributors! 



□ floss 



Free manuals for free software 



GNU GENERAL PUBLIC LICENSE 

Version 3, 29 June 2007 

Copyright © 2007 Free Software Foundation, Inc. < http://fsf.org/ > 

Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. 

Preamble 

The GNU General Public License is a free, copyleft license for software and other kinds of works. 

The licenses for most software and other practical works are designed to take away your freedom to share and change 
the works. By contrast, the GNU General Public License is intended to guarantee your freedom to share and change all 
versions of a program-to make sure it remains free software for all its users. We, the Free Software Foundation, use the 
GNU General Public License for most of our software; it applies also to any other work released this way by its authors. 
You can apply it to your programs, too. 

When we speak of free software, we are referring to freedom, not price. Our General Public Licenses are designed to 
make sure that you have the freedom to distribute copies of free software (and charge for them if you wish), that you 
receive source code or can get it if you want it, that you can change the software or use pieces of it in new free 
programs, and that you know you can do these things. 

To protect your rights, we need to prevent others from denying you these rights or asking you to surrender the rights. 
Therefore, you have certain responsibilities if you distribute copies of the software, or if you modify it: responsibilities to 
respect the freedom of others. 

For example, if you distribute copies of such a program, whether gratis or for a fee, you must pass on to the recipients 



the same freedoms that you received. You must make sure that they, too, receive or can get the source code. And you 
must show them these terms so they know their rights. 

Developers that use the GNU GPL protect your rights with two steps: (1) assert copyright on the software, and (2) offer 
you this License giving you legal permission to copy, distribute and/or modify it. 

For the developers' and authors' protection, the GPL clearly explains that there is no warranty for this free software. For 
both users' and authors' sake, the GPL requires that modified versions be marked as changed, so that their problems will 
not be attributed erroneously to authors of previous versions. 

Some devices are designed to deny users access to install or run modified versions of the software inside them, although 
the manufacturer can do so. This is fundamentally incompatible with the aim of protecting users' freedom to change the 
software. The systematic pattern of such abuse occurs in the area of products for individuals to use, which is precisely 
where it is most unacceptable. Therefore, we have designed this version of the GPL to prohibit the practice for those 
products. If such problems arise substantially in other domains, we stand ready to extend this provision to those domains 
in future versions of the GPL, as needed to protect the freedom of users. 

Finally, every program is threatened constantly by software patents. States should not allow patents to restrict 
development and use of software on general-purpose computers, but in those that do, we wish to avoid the special 
danger that patents applied to a free program could make it effectively proprietary. To prevent this, the GPL assures 
that patents cannot be used to render the program non-free. 

The precise terms and conditions for copying, distribution and modification follow. 
TERMS AND CONDITIONS 
0. Definitions. 

"This License" refers to version 3 of the GNU General Public License. 

"Copyright" also means copyright-like laws that apply to other kinds of works, such as semiconductor masks. 

"The Program" refers to any copyrightable work licensed under this License. Each licensee is addressed as "you". 
"Licensees" and "recipients" may be individuals or organizations. 

To "modify" a work means to copy from or adapt all or part of the work in a fashion requiring copyright permission, other 
than the making of an exact copy. The resulting work is called a "modified version" of the earlier work or a work "based 
on" the earlier work. 

A "covered work" means either the unmodified Program or a work based on the Program. 

To "propagate" a work means to do anything with it that, without permission, would make you directly or secondarily 
liable for infringement under applicable copyright law, except executing it on a computer or modifying a private copy. 
Propagation includes copying, distribution (with or without modification), making available to the public, and in some 
countries other activities as well. 

To "convey" a work means any kind of propagation that enables other parties to make or receive copies. Mere 
with a user through a computer network, with no transfer of a copy, is not conveying. 



An interactive user interface displays "Appropriate Legal Notices" to the extent that it includes 
prominently visible feature that (1) displays an appropriate copyright notice, and (2) tells the user that there is no 
warranty for the work (except to the extent that warranties are provided), that licensees may convey the work under 
this License, and how to view a copy of this License. If the interface presents a list of user commands or options, such as 
a menu, a prominent item in the list meets this criterion. 

1. Source Code. 

The "source code" for a work means the preferred form of the work for making modifications to it. "Object code" means 
any non-source form of a work. 

A "Standard Interface" means an interface that either is an official standard defined by a recognized standards body, or, 
in the case of interfaces specified for a particular programming language, one that is widely used among developers 
working in that language. 

The "System Libraries" of an executable work include anything, other than the work as a whole, that (a) is included in the 
normal form of packaging a Major Component, but which is not part of that Major Component, and (b) serves only to 
enable use of the work with that Major Component, or to implement a Standard Interface for which an impler 



ijor essential component 
ble work runs, or a 



available to the public in source code form. A "Major Component", in this context, means 
(kernel, window system, and so on) of the specific operating system (if any) on which the 
compiler used to produce the work, or an object code interpreter used to run it. 

The "Corresponding Source" for a work in object code form means all the source code needed to generate, install, and (for 
an executable work) run the object code and to modify the work, including scripts to control those activities. However, it 
does not include the work's System Libraries, or general-purpose tools or generally available free programs which are 
used unmodified in performing those activities but which are not part of the work. For example, Corresponding Source 
includes interface definition files associated with source files for the work, and the source code for shared libraries and 
dynamically linked subprograms that the work is specifically designed to require, such as by ir 
or control flow between those subprograms and other parts of the work. 
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2. Basic P( 



All rights granted under this License are granted for the term of copyright on the Program, and are irrevocable provided 
the stated conditions are met. This License explicitly affirms your unlimited permission to run the unmodified Program. 
The output from running a covered work is covered by this License only if the output, given its content, constitutes a 
covered work. This License acknowledges your rights of fair use or other equivalent, as provided by copyright law. 

You may make, run and propagate covered works that you do not convey, without conditions so long as your license 
otherwise remains in force. You may convey covered works to others for the sole purpose of having them make 
modifications exclusively for you, or provide you with facilities for running those works, provided that you comply with the 
terms of this License in conveying all material for which you do not control copyright. Those thus making or running the 
covered works for you must do so exclusively on your behalf, under your direction and control, on terms that prohibit 
them from making any copies of your copyrighted material outside their relationship with you. 
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permitted solely under the conditions stated below. Sublicensing is n 



3. Protecting Users' Legal Rights From Anti-Circur 



No covered work shall be deemed part of an effective technological measure under any applicable law fulfilling obligat 
under article 11 of the WIPO copyright treaty adopted on 20 December 1996, or similar laws prohibiting or restricting 
circumvention of such measures. 



When you convey a covered work, you waive any legal power to forbid circumvention of technological measures to the 
extent such circumvention is effected by exercising rights under this License with respect to the covered work, and you 
disclaim any intention to limit operation or modification of the work as a means of enforcing, against the work's users, 
your or third parties' legal rights to forbid circumvention of technological n 



4. Conveying Verbatim Copies. 



You may convey verbatim copies of the Program's source code as you receive it, in any medium, provided that you 
conspicuously and appropriately publish on each copy an appropriate copyright notice; keep intact all notices stating that 
this License and any non-permissive terms added in accord with section 7 apply to the code; keep intact all notices of the 
absence of any warranty; and give all recipients a copy of this License along with the Program. 



lay charge any price or no price for each copy that you convey, and you may offer support o 
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5. Conveying Modified Soi 



may convey a work based on the Program, or the modifications to produce it from the Program, in the form of 
ce code under the terms of section 4, provided that you also meet all of these conditions: 

• a) The work must carry prominent notices stating that you modified it, and giving a relevant date. 

• b) The work must carry prominent notices stating that it is released under this License and any conditions added 
under section 7. This requirement modifies the requirement in section 4 to "keep intact all notices". 

' c) You must license the entire work, as a whole, under this License to anyone who comes into possession of a copy. 
This License will therefore apply, along with any applicable section 7 additional terms, to the whole of the work, and 
all its parts, regardless of how they are packaged. This License gives no permission to license the work in any other 
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way, but it does not invalidate such permission if you have separately received it. 
• d) If the work has interactive user interfaces, each must display Appropriate Legal Notices; however, if the Program 
has interactive interfaces that do not display Appropriate Legal Notices, your work need not make them do so. 



A compilation of a covered work with other separate and independent works, which are not by their nat 
the covered work, and which are not combined with it such as to form a larger program, in or on a volume of a storage 
or distribution medium, is called an "aggregate" if the compilation and its resulting copyright are not used to limit the 
access or legal rights of the compilation's users beyond what the individual works permit. Inclusion of a covered work in 
an aggregate does not cause this License to apply to the other parts of the aggregate. 

6. Conveying Non-Source Forms. 

You may convey a covered work in object code form under the terms of sections 4 and 5, provided that you also convey 
the machine-readable Corresponding Source under the terms of this License, in one of these ways: 

• a) Convey the object code in, or embodied in, a physical product (including a physical distribution medium), 
accompanied by the Corresponding Source fixed on a durable physical medium customarily used for software 
interchange. 

• b) Convey the object code in, or embodied in, a physical product (including a physical distribution medium), 
accompanied by a written offer, valid for at least three years and valid for as long as you offer spare parts or 
customer support for that product model, to give anyone who possesses the object code either (1) a copy of the 
Corresponding Source for all the software in the product that is covered by this License, on a durable physical 
medium customarily used for software interchange, for a price no more than your reasonable cost of physically 
performing this conveying of source, or (2) access to copy the Corresponding Source from a network server at no 

• c) Convey individual copies of the object code with a copy of the written offer to provide the Corresponding Source. 
This alternative is allowed only occasionally and noncommercially, and only if you received the object code with such 
an offer, in accord with subsection 6b. 

• d) Convey the object code by offering access from a designated place (gratis or for a charge), and offer equivalent 
access to the Corresponding Source in the same way through the same place at no further charge. You need not 
require recipients to copy the Corresponding Source along with the object code. If the place to copy the object code 
is a network server, the Corresponding Source may be on a different server (operated by you or a third party) that 
supports equivalent copying facilities, provided you maintain clear directions next to the object code saying where to 
find the Corresponding Source. Regardless of what server hosts the Corresponding Source, you remain obligated to 
ensure that it is available for as long as needed to satisfy these requirements. 

• e) Convey the object code using peer-to-peer transmission, provided you inform other peers where the object code 
and Corresponding Source of the work are being offered to the general public at no charge under subsection 6d. 

A separable portion of the object code, whose source code is excluded from the Corresponding Source as a System 
Library, need not be included in conveying the object code work. 

A "User Product" is either (1) a "consumer product", which means any tangible personal property which is normally used 
for personal, family, or household purposes, or (2) anything designed or sold for incorporation into a dwelling. In 
determining whether a product is a consumer product, doubtful cases shall be resolved in favor of coverage. For a 
particular product received by a particular user, "normally used" refers to a typical or common use of that class of 
product, regardless of the status of the particular user or of the way in which the particular user actually uses, or 
expects or is expected to use, the product. A product is a consumer product regardless of whether the product has 
substantial commercial, industrial or non-consumer uses, unless such uses represent the only significant mode of use of 
the product. 

"Installation Information" for a User Product means any methods, procedures, authorization keys, or other information 
required to install and execute modified versions of a covered work in that User Product from a modified version of its 
Corresponding Source. The information must suffice to ensure that the continued functioning of the modified object code 
is in no case prevented or interfered with solely because modification has been made. 

If you convey an object code work under this section in, or with, or specifically for use in, a User Product, and the 
conveying occurs as part of a transaction in which the right of possession and use of the User Product is transferred to 
the recipient in perpetuity or for a fixed term (regardless of how the transaction is characterized), the Corresponding 
Source conveyed under this section must be accompanied by the Installation Information. But this requirement does not 
apply if neither you nor any third party retains the ability to install modified object code on the User Product (for 
example, the work has been installed in ROM). 

The requirement to provide Installation Information does not include a requirement to continue to provide support 
service, warranty, or updates for a work that has been modified or installed by the recipient, or for the User Product in 
which it has been modified or installed. Access to a network may be denied when the modification itself materially and 
adversely affects the operation of the network or violates the rules and protocols for communication across the network. 
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Corresponding Source conveyed, and Installation Information provided, in accord with this section must be in a format 
that is publicly documented (and with an implementation available to the public in source code form), and must require no 
special password or key for unpacking, reading or copying. 

7. Additional Terms. 

"Additional permissions" are terms that supplement the terms of this License by making exceptions from one or more of 
its conditions. Additional permissions that are applicable to the entire Program shall be treated as though they were 
included in this License, to the extent that they are valid under applicable law. If additional permissions apply only to part 
of the Program, that part may be used separately under those permissions, but the entire Program remains governed by 
this License without regard to the additional permissions. 

When you convey a copy of a covered work, you may at your option remove any additional permissions from that copy, 
or from any part of it. (Additional permissions may be written to require their own removal in certain cases when you 
modify the work.) You may place additional permissions on material, added by you to a covered work, for which you have 
or can give appropriate copyright permission. 

Notwithstanding any other provision of this License, for material you add to a covered work, you may (if authorized by 
the copyright holders of that material) supplement the terms of this License with terms: 

• a) Disclaiming warranty or limiting liability differently from the terms of sections 15 and 16 of this License; or 

• b) Requiring preservation of specified reasonable legal notices or author attributions in that material or in the 
Appropriate Legal Notices displayed by works containing it; or 

• c) Prohibiting misrepresentation of the origin of that material, or requiring that modified versions of such material be 
marked in reasonable ways as different from the original version; or 

• d) Limiting the use for publicity purposes of names of licensors or authors of the material; or 

• e) Declining to grant rights under trademark law for use of some trade names, trademarks, or service marks; or 

• f) Requiring indemnification of licensors and authors of that material by anyone who conveys the material (or 
modified versions of it) with contractual assumptions of liability to the recipient, for any liability that these 
contractual assumptions directly impose on those licensors and authors. 

All other non-permissive additional terms are considered "further restrictions" within the meaning of section 10. If the 
Program as you received it, or any part of it, contains a notice stating that it is governed by this License along with a 
term that is a further restriction, you may remove that term. If a license document contains a further restriction but 
permits relicensing or conveying under this License, you may add to a covered work material governed by the terms of 
that license document, provided that the further restriction does not survive such relicensing or conveying. 

If you add terms to a covered work in accord with this section, you must place, in the relevant source files, a statement 
of the additional terms that apply to those files, or a notice indicating where to find the applicable terms. 

Additional terms, permissive or non-permissive, may be stated in the form of a separately written license, or stated as 
exceptions; the above requirements apply either way. 



You may not propagate or modify a covered work except as expressly provided under this License. Any attempt 
otherwise to propagate or modify it is void, and will automatically terminate your rights under this License (including any 
patent licenses granted under the third paragraph of section 11). 

However, if you cease all violation of this License, then your license from a particular copyright holder is reinstated (a) 
provisionally, unless and until the copyright holder explicitly and finally terminates your license, and (b) permanently, if the 
copyright holder fails to notify you of the violation by some reasonable means prior to 60 days after the cessation. 

Moreover, your license from a particular copyright holder is reinstated permanently if the copyright holder notifies you of 
the violation by some reasonable means, this is the first time you have received notice of violation of this License (for 
any work) from that copyright holder, and you cure the violation prior to 30 days after your receipt of the notice. 

Termination of your rights under this section does not terminate the licenses of parties who have received copies or 
rights from you under this License. If your rights have been terminated and not permanently reinstated, you do not 
qualify to receive new licenses for the same material under section 10. 



9. Acceptance Not Required for Having Copies. 

You are not required to accept this License in order to receive or run a copy of the Program. Ancillary propagation of a 
covered work occurring solely as a consequence of using peer-to-peer transmission to receive a copy likewise does not 
require acceptance. However, nothing other than this License grants you permission to propagate or modify any covered 
work. These actions infringe copyright if you do not accept this License. Therefore, by modifying or propagating a covered 
work, you indicate your acceptance of this License to do so. 

10. Automatic Licensing of Downstream Recipients. 

Each time you convey a covered work, the recipient automatically receives a license from the original licensors, to run, 
modify and propagate that work, subject to this License. You are not responsible for enforcing compliance by third parties 
with this License. 

An "entity transaction" is a transaction transferring control of an organization, or substantially all assets of one, or 
subdividing an organization, or merging organizations. If propagation of a covered work results from an entity transaction, 
each party to that transaction who receives a copy of the work also receives whatever licenses to the work the party's 
predecessor in interest had or could give under the previous paragraph, plus a right to possession of the Corresponding 
Source of the work from the predecessor in interest, if the predecessor has it or can get it with reasonable efforts. 

You may not impose any further restrictions on the exercise of the rights granted or affirmed under this License. For 
example, you may not impose a license fee, royalty, or other charge for exercise of rights granted under this License, and 
you may not initiate litigation (including a cross-claim or counterclaim in a lawsuit) alleging that any patent claim is 
infringed by making, using, selling, offering for sale, or importing the Program or any portion of it. 

11. Patents. 

A "contributor" is a copyright holder who authorizes use under this License of the Program or a work on which the 
Program is based. The work thus licensed is called the contributor's "contributor version". 

A contributor's "essential patent claims" are all patent claims owned or controlled by the contributor, whether already 
acquired or hereafter acquired, that would be infringed by some manner, permitted by this License, of making, using, or 
selling its contributor version, but do not include claims that would be infringed only as a consequence of further 
modification of the contributor version. For purposes of this definition, "control" includes the right to grant patent 
sublicenses in a manner consistent with the requirements of this License. 

Each contributor grants you a non-exclusive, worldwide, royalty-free patent license under the contributor's essential 
patent claims, to make, use, sell, offer for sale, import and otherwise run, modify and propagate the contents of its 
contributor version. 

In the following three paragraphs, a "patent license" is any express agreement or commitment, however denominated, 
not to enforce a patent (such as an express permission to practice a patent or covenant not to sue for patent 
infringement). To "grant" such a patent license to a party means to make such an agreement or commitment not to 
enforce a patent against the party. 

If you convey a covered work, knowingly relying on a patent license, and the Corresponding Source of the work is not 
available for anyone to copy, free of charge and under the terms of this License, through a publicly available network 
server or other readily accessible means, then you must either (1) cause the Corresponding Source to be so available, or 
(2) arrange to deprive yourself of the benefit of the patent license for this particular work, or (3) arrange, in a manner 
consistent with the requirements of this License, to extend the patent license to downstream recipients. "Knowingly 
relying" means you have actual knowledge that, but for the patent license, your conveying the covered work in a country, 
or your recipient's use of the covered work in a country, would infringe one or more identifiable patents in that country 
that you have reason to believe are valid. 

If, pursuant to or in connection with a single transaction or arrangement, you convey, or propagate by procuring 
conveyance of, a covered work, and grant a patent license to some of the parties receiving the covered work authorizing 
them to use, propagate, modify or convey a specific copy of the covered work, then the patent license you grant is 
automatically extended to all recipients of the covered work and works based on it. 

A patent license is "discriminatory" if it does not include within the scope of its coverage, prohibits the exercise of, or is 
conditioned on the non-exercise of one or more of the rights that are specifically granted under this License. You may not 
convey a covered work if you are a party to an arrangement with a third party that is in the business of distributing 
software, under which you make payment to the third party based on the extent of your activity of conveying the work, 
and under which the third party grants, to any of the parties who would receive the covered work from you, a 
discriminatory patent license (a) in connection with copies of the covered work conveyed by you (or copies made from 
those copies), or (b) primarily for and in connection with specific products or compilations that contain the covered work, 
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unless you entered into that arrangement, or that patent license was granted, prior to 28 March 2007. 

Nothing in this License shall be construed as excluding or limiting any implied license or other defenses to infringement 
that may otherwise be available to you under applicable patent law. 

12. No Surrender of Others' Freedom. 

If conditions are imposed on you (whether by court order, agreement or otherwise) that contradict the conditions of this 
License, they do not excuse you from the conditions of this License. If you cannot convey a covered work so as to satisfy 
simultaneously your obligations under this License and any other pertinent obligations, then as a consequence you may 
not convey it at all. For example, if you agree to terms that obligate you to collect a royalty for further conveying from 
those to whom you convey the Program, the only way you could satisfy both those terms and this License would be to 
refrain entirely from conveying the Program. 

13. Use with the GNU Affero General Public License. 

Notwithstanding any other provision of this License, you have permission to link or combine any covered work with a 
work licensed under version 3 of the GNU Affero General Public License into a single combined work, and to convey the 
resulting work. The terms of this License will continue to apply to the part which is the covered work, but the special 
requirements of the GNU Affero General Public License, section 13, concerning interaction through a network will apply to 
the combination as such. 

14. Revised Versions of this License. 

The Free Software Foundation may publish revised and/or new versions of the GNU General Public License from time to 
time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems 
or concerns. 

Each version is given a distinguishing version number. If the Program specifies that a certain numbered version of the GNU 
General Public License "or any later version" applies to it, you have the option of following the terms and conditions either 
of that numbered version or of any later version published by the Free Software Foundation. If the Program does not 
specify a version number of the GNU General Public License, you may choose any version ever published by the Free 
Software Foundation. 

If the Program specifies that a proxy can decide which future versions of the GNU General Public License can be used, 
that proxy's public statement of acceptance of a version permanently authorizes you to choose that version for the 

Later license versions may give you additional or different permissions. However, no additional obligations are imposed on 
any author or copyright holder as a result of your choosing to follow a later version. 

15. Disclaimer of Warranty. 

THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN 
OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" 
WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED 
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY 
AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE 
COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. 

16. Limitation of Liability. 

IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR 
ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR 
DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE 
OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED 
INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH 
ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH 
DAMAGES. 



17. Interpretation of Sections 15 and 16. 

If the disclaimer of warranty and limitation of liability provided above cannot be given local legal effect according to their 
terms, reviewing courts shall apply local law that most closely approximates an absolute waiver of all civil liability in 
connection with the Program, unless a warranty or assumption of liability accompanies a copy of the Program in return 

END OF TERMS AND CONDITIONS 
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